【汎用ソフトスキル】ドキュメンテーションの続け方

2022/03/29 227 users 続け方

この記事の目的 最近「良いドキュメントが作れているな」と思う機会が増えてきたので、その知見をアウトプットしたくなった。 想定読者 今所属してる組織(会社/プロジェクトなど)のドキュメントがイマイチで悩んでいる人 そもそもドキュメントが無い組織に所属していてつらい思いをしている人 「ドキュメントを作れ」と... 続きを読む

継続的ドキュメンテーション: Github DiscussionsとADRのすすめ - LIFULL Creators Blog

2021/09/11 137 users ADR GitHub Discussions

こんにちは。テクノロジー本部のyoshikawaです。好きなW3C Recommendation は RDF 1.1 Concepts and Abstract Syntax です。 会議やチャットでのやり取りの決定事項・議事録、アプリケーションや機能の設計書・仕様書、READMEなどなど... LIFULLの開発現場においては、ソースコード以外にもこのように様々な文書の管理・... 続きを読む

プログラマーがドキュメントを書かない理由 - ITnews

2021/06/03 495 users ITnews medium トキ プログラマー ドキュメント

この記事は、著者の許可を得て配信しています。 Why programmers don’t write documentation 最近ではずっとコードのドキュメンテーションに関連した記事を書いていたので、当然、私のMediumのおすすめ記事には「開発者がドキュメントを書かない本当の理由」という記事が表示されるようになりました。この記事では、ドキ... 続きを読む

リモートワークのいま学びたい、GitLab Handbookと徹底した文書化への狂気 - Qiita

2021/03/01 259 users Qiita Problem リモートワーク GitLab 狂気

Help us understand the problem. What is going on with this article? 1200人以上の全社員がリモートワーク。GitLabが公開する「リモートワークマニフェスト」は何を教えているか？ スケールする組織を支えるドキュメンテーションの技術を”GitLab Handbook”から学ぶ その コメント GitLab Handbookで面白かったもの@コ... 続きを読む

Oh Shit, Git!?!

2020/11/12 425 users Git ニワトリ oh shit 事柄 ハマリ

Gitって難しい。簡単にぐちゃぐちゃの状態になっちゃうし、失敗を直す方法を知ろうとしたところでまじくそ不可能。Gitのドキュメンテーションって卵とニワトリの問題みたいなところがあって、ハマりから抜け出すために知ってないといけない事柄の名前をあらかじめ知っていないと、どうやって問題を解決したらいいのか検... 続きを読む

スケールする組織を支えるドキュメンテーションの技術を”GitLab Handbook”から学ぶ｜Anno Takahiro｜note

2020/02/14 265 users スゲー GitLab Handbook 口頭 スケール 組織

ドキュメント文化は健全な組織のスケールのために必要　組織の中でドキュメント/文章を残し活用していくことはとても重要だ。クオリティの高いドキュメントがあることで、組織に情報が流通し、透明性を確保できるようになる。情報を流通させるためにいちいち口頭の説明がいらないから、メンバーの数が増えた時でもスケー... 続きを読む

Googleが社内のドキュメンテーションスタイルガイドを公開 | TechCrunch Japan

2017/09/08 636 users TechCrunch JAPAN Google 社内 公開

ドキュメンテーションは往々にして、後（あと）からの付け足しだ。オープンソースのプロジェクトではとくにそれが多い。そのため新しい人が後日そのプロジェクト参加しづらくなったり、ときにはヘタなドキュメンテーションのせいでコードがかえってわかりづらくなることもある。そこでGoogleは、デベロッパーがもっと良いドキュメンテーションを書けるために、同社の developer-documentation st... 続きを読む

2016/09/15 141 users angular バグ修正 正式リリース後 解説 予定

どうも、らこです。 ついに Angular 2.0.0が正式リリースされました ！めでたい！！ 今回はRC.7も含めた変更点の解説に加えて、正式リリース後のAngularの予定についても紹介します。 RC.6からの変更点 RC.7、2.0.0ともに、ほとんどがバグ修正とドキュメンテーションの追加で、破壊的な変更はRC.7にひとつあるだけです。 2.0.0-RC.7 2.0.0 破壊的変更 ...M... 続きを読む

Twitter謹製のCSSフレームワーク『Bootstrap』が大幅バージョンアップ中！ | IDEA*IDEA

2011/09/18 463 users Bootstrap IDEA CSSフレームワーク 本日

以前ご紹介したBootstrapですが、良い感じにマイナーバージョンアップを繰り返しているようです。地味にウォッチしていたのですが、本日、v1.3.0になってかなり使いやすくなったので再度ご紹介。 ■ JavaScriptライブラリも出来た！ これが一番うれしいぞ！ 以前はドキュメンテーションがいまいちで、完全に動作させるにはデモページのJavaScriptを解析して・・・なんてことが必要だったの... 続きを読む

ドキュメンテーションを加速するストレスフリーの作図ツール『Blockdiag』 jus2011年6月勉強会

2011/06/19 459 users blockdiag 作図ツール or above

ドキュメンテーションを加速するストレスフリーの作図ツール『Blockdiag』 jus2011年6月勉強会 2 hours ago Loading… Flash Player 9 (or above) is needed to view presentations. We have detected that you do not have it on your computer. To inst... 続きを読む