技術文書の書き方
howto-tech-docs.md 技術文書の書き方 このメモは、私（@ymmt2005）が長年にわたってソフトウェアプロダクト開発に関わってきて 2022年現在こうしたほうが良いと考えているベストプラクティスです。 科学的な分析等に基づくわけではない経験則であるため、今後も随時見直すことがありますし、 ここに書いてあることが常に正しいわけでもあらゆるソフトウェア開発に適するわけでもありません。 しかしながら、実務経験が豊富で、モダンな技術スタックに明るいエンジニアの経験則は一定の 役に立つのではないかと考えて記します。 技術文書とは ここでは、ソフトウェア開発で技術者が書くべき文書ということにします。 ソフトウェアエンジニアにも役割がいろいろあり、アーキテクトと independent contributor では書く文書が違うということはあるでしょうけれど、ここではごっちゃにします。
「いつかGitHubで働きたい」10年来の空想を現実にしたソフトウェアエンジニアの紆余曲折な人生 - Findy Engineer Lab
長永健介（@kyanny）と申します。現在はGitHubで働いています。10年前、「いつかここで働きたい」と夢見た会社です。 私は子供の頃から「考えること」が好きでした。難しいこともくだらないことも、真面目に考えて自分なりの意見をまとめる癖がありました。成長するにつれて私の思考様式は洗練され、Webとブログに出会ったことで「書く」という手段に昇華されました。書くことで考えていることを言語化し、言語化した自分の考えを読みながらさらに考えを深める ── この活動を繰り返すことで、起こりうる問題に備えたり、問題を多角的に見つめて活路を見出してきました。 とりわけキャリアの選択において「(思考|志向)を言語化する」習慣が大いに役立ちました。この記事では私のキャリアにおけるいくつかの選択と、その時々で考えていたことについて紹介します。 望んでなかった「けものみち」を変えた日記の言葉 Shut the
クリーンアーキテクチャ完全に理解した
clean_architecture.md 2020/5/31追記: 自分用のメモに書いていたつもりだったのですが、たくさんのスターを頂けてとても嬉しいです。 と同時に、書きかけで中途半端な状態のドキュメントをご覧いただくことになっており、大変心苦しく思っています。 このドキュメントを完成させるために、今後以下のような更新を予定しています。 TODO部分を埋める 書籍を基にした理論・原則パートと、実装例パートを分割 現在は4層のレイヤそれぞれごとに原則の確認→実装時の課題リスト→実装例という構成ですが、同じリポジトリへの言及箇所がバラバラになってしまう問題がありました。更新後は、実装時の課題リストを全て洗い出した後にまとめて実装を確認する構成とする予定です。 2021/1/22追記: パートの分割と、クリーンアーキテクチャという概念の定義について追記を行いました。大部分の実装例パートを中心
GitHub、これから作成するリポジトリのデフォルトブランチ名が「main」に。「master」から「main」へ変更
GitHubは、これから新規に作成されるリポジトリのデフォルトブランチ名が「main」になると発表しました。これまでデフォルトブランチ名は「master」でした。 既存のリポジトリにはこの変更は適用されませんが、年内にも既存のリポジトリでもデフォルトブランチ名の変更を可能にする予定だと説明されています。下記は「The default branch for newly-created repositories is now main」からの引用です。 Existing repositories are not impacted by this change. Later this year, you'll be able to rename the default branch for existing repositories for your user, organization, or
GAS 家計簿 - Google Apps ScriptとVueで作られたWeb家計簿
MOONGIFTはオープンソース・ソフトウェアを紹介するブログです。2021年07月16日で更新停止しました IT技術の発展はめざましく、日々新しい技術が登場しています。例えばサーバレス、VueやReactの仮想DOM、ちょっと前であればRESTful APIなどがあります。それらを漏れなくキャッチアップするのは大変です。 今回紹介するGAS 家計簿はサーバレスにGAS（Google Apps Script）を使って家計簿Webアプリケーションを作るハンズオンを兼ねたソフトウェアです。 GAS 家計簿の使い方 デモです。動作しているのはGitHub Pagesです。サーバの管理が不要ですね。 データの追加用モーダルウィンドウ。フロントエンドはVueを使っています。 設定画面です。データはGoogle Apps Scriptを使ってGoogleスプレッドシートに保存されています。 GAS 家
GitHubが「Pull Panda」買収を発表。プルリクのSlackリマインダーやレビュアーの公平な割り当てなど、全機能が無料に
GitHubが「Pull Panda」買収を発表。プルリクのSlackリマインダーやレビュアーの公平な割り当てなど、全機能が無料に GitHubは、GitHub関連ツールベンダ「Pull Panda」の買収を発表しました。この買収発表と同時に、Pull Pandaが提供していた3つのソフトウェア「Pull Reminders」「Pull Analytics」「Pull Assigner」はすべてGitHub Marketplaceで無料公開され、だれでも使えるようになりました。 Pull Remindersは、プルリクエストに対する作業を自動的にSlackにリマインドしてくれる機能を提供します。これによりプルリクエストへの対応が忘れられたままになるのを防ぐことができます。
この10年でソフトウェア開発はどう変わったか？――"The State of the Octoverse"から見る世界の開発トレンド／担当者インタビュー【GitHub Universe】
2018年、GitHubのリポジトリ数は1億件を達成した。これはGitHubが年に一度発表する、世界の開発者および開発環境に関する情報をまとめたレポート「The State of the Octoverse」の中で紹介された数字だ。同社のデータサイエンティストチームによって作成されたこのレポートは、開発トレンドを把握し、今後のソフトウェア開発事情を見通すうえで非常に重要な役割を担っている。そのレポートの注目ポイントが、2018年10月に開催されたGitHub Universeでのセッション“State of the Octoverse”で語られた。また、セッションに登壇したデータサイエンティストAnna Filippova氏にインタビューを敢行した。 急成長地域や人気の言語…この1年のトレンドは？ 「The State of the Octoverse」は毎年10月にGitHubがまとめて
世界最大のソフトウェア開発プラットフォームで最も人気なプログラミング言語は何なのか？
by Alper Çuğun コンピュータープログラムを記述するために使用されるプログラミング言語には非常にさまざまな種類があり、それぞれに特色や長所・短所を持っています。そんなプログラミング言語と密接に関わっているソフトウェア開発プラットフォームのGitHubが、「2018年で最も人気のあったプログラミング言語」についてまとめています。 The State of the Octoverse: top programming languages of 2018 | The GitHub Blog https://blog.github.com/2018-11-15-state-of-the-octoverse-top-programming-languages/ ソースコードを共有するGitHubにとってプログラミング言語はサービスの中核を担うものであり、「いったいどのプログラミング言語が
GitHub活用の最前線｜シリコンバレーの企業でGitHub導入が進む背景、そして成功ケースとは？ | キャリアハック（CAREER HACK）
9歳の頃からエンジニアを志していたというマシュー氏。より多くの人に学習の機会をつくるために自身が進む道を選んできた。そういった意味でオープンソースコミュニティへの貢献、そしてGitHubへのジョインは自然な流れだったのかもしれない。 マシュー氏は現在、世界中を飛びまわり、企業でのGitHub導入・活用を支援する。オープンソースを用いてどうプロジェクトを成功させるか。日本の企業にも広まっていくか。シリコンバレーでの成功事例をもとにお話を伺った。 「優秀な人」と「良いツール」が揃ってこそプロジェクトは成功する ― シリコンバレーでは大企業でもGitHubの活用が進んでいると伺いました。その背景について教えてください。 まずシリコンバレーの企業、特にソフトウェアのディベロッパーが理解しているのは、プロジェクトを成功させるためには「優秀な人」と「良いツール」、その双方が必要だということです。 優秀
Dropboxがチャットアプリ「Zulip」をオープンソースライセンスでリリース - BRIDGE（ブリッジ）テクノロジー＆スタートアップ情報
<ピックアップ>Dropbox releases its chat app Zulip under an open-source license Dropboxが職場環境向けチャットアプリ「Zulip」をオープンソースライセンスでリリースしました。「Zulip」は、昨年2014年にDropboxが買収したスタートアップ。 アプリはMacとWindowsのデスクトップアプリ、iOSとAndroidのスマホアプリで提供されています。なお、「Zulip」のコードはGitHub上で公開されています。 Open Sourcing Zulip – a Dropbox Hack Week Project via The Next Web BRIDGE Members BRIDGEでは会員制度の「Members」を運営しています。登録いただくと会員限定の記事が毎月3本まで読めるほか、Discordの招待リ
社内で立てられるGistサーバ·Gistub MOONGIFT
GistubはGitHubの提供するGistのクローンです。 GitHubの提供するスニペットサービスのGist。便利に使っている人も多いと思いますが、何となく会社で使うのは控えてしまっている…そんな人も多いでしょう。そこで社内で立てられるGistクローンGistubを使ってみましょう。 パブリックなGist一覧。 ソースコードハイライト付きです。 編集画面です。 編集すると履歴がつきます。 新しいGistの追加画面。 プライベートなGistも作成できます。 Gistubはエディター画面こそ単純なテキストボックスで、ハイライトする言語指定ができないものの他はGistと変わらず普通に使えるようになっています。社内で立ててチームで使ったりするのに良いのではないでしょうか。 GistubはRuby/Ruby on Rails製、MIT Licenseのオープンソース・ソフトウェアです。 MOON
1
リリース、障害情報などのサービスのお知らせ
最新の人気エントリーの配信
j次のブックマーク
k前のブックマーク
lあとで読む
eコメント一覧を開く
oページを開く
GitHub - nette/php-generator: 🐘 Generates neat PHP code for you. Supports new PHP 8.2 features.
GitHub - mercari/production-readiness-checklist: Production readiness checklist used for Mercari and Merpay microservices