ドキュメントに固執せよ - gfnweb
どうして人間集団はこんなにも知見の共有を円滑にできないのか？ 改善にはドキュメントにまつわる各個人の心構え・制度設計・技術的解決の全部が必要だという話をしたい． ここでテーマにしているのは，著名OSSなど世の中にいくらでも知見が転がっている対象ではなく，特に企業内の十数人のチームでクローズドに開発しているなどして集合知に頼れない状況下でのドキュメントについてである． 非常に乱暴な言い方をするなら，「コードとか大部分は誰でも書けるようになるものなんよ，そんなところにマッチョイズムとか感じなくてええねん，我々の知的体力や組織性が真に試されるのはドキュメントちゃうんか」という気持ちです — 画力・博士号・油田 (@bd_gfngfn) June 3, 2022 ドキュメントに書く内容の必須項目或るシステム（ソフトウェアなど）について，そのシステムのことを全く知らない人を想定読者としたドキュメント
やらないなんてもったいない！チーム開発におけるコードレビューのススメ | クリエイターのための総合情報サイト CREATIVE VILLAGE
みなさんのチームでは、コードレビューは行っているでしょうか？ メンバーズエッジカンパニーではリモートチームによるアジャイル開発を行っており、自分のチームでは言語にPython、フレームワークにDjangoを使った、業務系システムを作っています。 自分のチームでもコードレビューを行っていますが、自分はチームの立ち上げから関わり、かつプログラマーとしての経験も長いため、レビューをする立場が多いです。 この記事では、チーム開発においてのコードレビューの意義と手段について紹介していきます。 池本 英貴（いけもと ひでき）氏 株式会社メンバーズ メンバーズエッジカンパニー Webエンジニア 2019年中途入社。 神戸オフィスにて1年間の修行後、愛媛県にてフル在宅勤務中。 好きなハードはNeXTcubeです。 コードレビューの意義 コードレビューをする意義は何でしょうか。自分は4つあると考えています。
Keep a Changelog
Version 1.0.0 # Changelog All notable changes to this project will be documented in this file. The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/), and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html). ## [Unreleased] ## [1.1.1] - 2023-03-05 ### Added - Arabic translation (#444). - v1.1 French translation. - v1.1 Dutch translation (#371
GitHubは著作権クレームに真っ向勝負！ YouTubeダウンローダー復活＆デベロッパ保護基金設立
GitHubは著作権クレームに真っ向勝負！ YouTubeダウンローダー復活＆デベロッパ保護基金設立2020.11.19 09:009,095 Rhett Jones - Gizmodo US ［原文］ （ そうこ ） いけ、オクトキャット！ GitHubにポストされていたYouTubeのコンテンツをダウンロードするためのツール｢YouTube-dl｣。アメリカレコード協会からデジタルミレニアム著作権法に当たるとの要請をうけ、GitHub運営がこのツールを非公開としたのが約3週間前。しかし、落胆するデベロッパを目にしてGitHubは方向転換。デベロッパを、彼らの作品を守るべきだと結論をだし、今週月曜日、再びYouTube-dl公開に踏み切りました。 YouTube-dlは、GitHub上で出回っているプログラムの中でもかなり人気のコード。しかし、アメリカレコード協会が懸念・指摘したのは、こ
Python Developer’s Guide
Python Developer’s Guide# This guide is a comprehensive resource for contributing to Python – for both new and experienced contributors. It is maintained by the same community that maintains Python. We welcome your contributions to Python! Quick reference# Here are the basic steps needed to get set up and contribute a patch. This is meant as a checklist, once you know the basics. For complete inst
SPAのルーティングの話
【第26回Elasticsearch勉強会】Logstashとともに振り返る、やっちまった事例ごった煮
ReactとVueのどちらを選ぶか - Qiita
主に非Web系のバックエンド開発者(C/C++, Java, Python等を使用)がReactとVueをそれぞれ簡単に触れて、感じたメリット、思ったことなどをまとめています。 色々と書いてますが、どちらも完成度の高いライブラリ/フレームワークですね。 結論 JavaScript等にあまり深入りせずにWebアプリを簡単に書きたい、あるいは効率的に書くことが目的であればVueの方がお勧めです。しかし開発者としてスキルや設計などについて中長期的にレベルアップを図りたいのであれば、Reactから学ぶことをお勧めします。 何故かと言うと、ReactとVueにはそれぞれの利用者に対するスタンスが明確に異なり、Reactの方が利用者を開発者であることを想定/期待しているからです。 Reactは利用者が「開発者」であることを想定/期待します。 What, Whyを重視する 利用者を厳しめに教育する Vu
2020年度新人研修をアップデートした話 - FLINTERS Engineer's Blog
こんにちは。新卒2年目の原田です。 以前は開発チームに所属していましたが、現在は教育チームに所属しています。 その背景として、私は昨年から個人的な目線ですが社内に教育に対して興味ある方や協力的な方が多くないように感じており、何か自分にできることはないだろうかと考えることがありました。先輩方にも何度かお話をさせていただき、当時自分がやるべきことやアクションにアドバイスしてもらいました。 また、過去にプログラミングではなくスポーツですが、人に教えて、その人が活躍した時にとてもやりがいを感じたことがあり、教育自体にも興味を持っていました。 以上から、会社に要望を出して今年の3月から教育チームに所属することになりました。 2020年度新人研修の教育カリキュラムを、前年度と比較して大幅にアップデートしたので紹介します。 ちなみに今年度は6名の方が入社してくれました！👏 こんなことになるとは...
Goで開発していたが、途中でPythonに切り替えた件を振り返る。 - Qiita
イントロダクション 目下、開発中のプロダクトなので詳しいことは書けないのですが、いろいろと気付きの多い出来事だったので、 少し自分自信の振り返りも兼ねて、投稿してみたいと思います。 これは、決してGoよりPythonのほうが優れているとかそういった話ではないです。 今回、自分は開発者というよりプロジェクトマネージャー（以降、PM）という立場になります。 Goの採用 当社のコア技術はPythonなのですが、今回、開発にあたってGoを採用していました。 主な採用理由としては、「プロトコルとしてgRPCを採用するにあたって、gRPCとの組み合わせ事例が多い」からでした。 gRPCの採用理由は、「同時に企画されていた別プロダクト（Python）との連携が想定されており、異なるプログラミング言語間でも型を維持したままデータ交換が可能」なことからでした。 当初は、プロダクトのリリース時期も未定でプロト
アーキテクチャ設計における垂直思考と水平思考 - kawasima
このADRをレビューするにあたっては、コンテキストのセクションもよくよく議論すべきで、意思決定が妥当かだけ見ても、「実はコンテキストに誤りやあやふやなところがありA案よりもB案の方が良かった…」みたいなことが発生するし、十分にコンテキストが理解されていない第3者や有識者をまじえてのレビューでは、レビューアに意思決定の構造を理解してもらいにくい、ということもある。
Developer Roadmaps - roadmap.sh
New Generate visual roadmaps with AIAI Roadmap Generator! Developer Roadmaps roadmap.sh is a community effort to create roadmaps, guides and other educational content to help guide developers in picking up a path and guide their learnings. Community created roadmaps, guides and articles to help developers grow in their career.
テストの説明に安易に「正しく」とか書かない - Object.create(null)
みなさんテストは書いていますよね. 書いていなければふりだしに戻る. 例えば関数 add に対して, 以下のようなテストコードがあるとします. describe("add", () => { it("正しく計算できる", () => { expect(add(1, 2)).toBe(3); }); }); よさそうですね? もしよくないと思うのであればここから下は読まなくても大丈夫なくらい理解している方だと思います. 続いて関数名を変えただけのこちらをどうぞ. describe("sub", () => { it("正しく計算できる", () => { expect(sub(1, 2)).toBe(3); }); }); なんだか明らかに間違っている気がします. もしこのテストが通過してしまったとき我々はどうすればよいのでしょうか. 考えられるパターンは 2 つあります. 実装もテストも正
1
リリース、障害情報などのサービスのお知らせ
最新の人気エントリーの配信
j次のブックマーク
k前のブックマーク
lあとで読む
eコメント一覧を開く
oページを開く
