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

テクノロジーカテゴリーの変更を依頼記事元:

www.lifull.blog

204 usersがブックマークコメント

記事へのコメント8件

注目コメント
新着コメント

hiroomi “社内WikiやREADME(Markdownファイル)でのドキュメントの作成と管理に限界を感じている人”MS365でやっても地獄。

2021/09/19 リンク

yarumato “構造化され整ったドキュメントを書くこと（textlintの厳格な指摘に合格する。階層構造を維持する）がつらい。解消できる別の仕組みADR：アーキテクチャ上の決定事項を、背景や結果とともに記録する手法”

2021/09/19 リンク

SWIMATH2 よさそう

2021/09/19 リンク

akahigeg “GitHub Discussions”

2021/09/19 リンク

clash_m45 すごく良さそう

2021/09/19 リンク

arc_at_dmz #sigpx

2021/09/18 リンク

efcl GitHub Discussions × ADR

2021/09/18 リンク

sh19910711 ドキュメンテーションに使うの良さそう / "Discussionsで記載された「とりあえず残したいもの」を「決まりきったもの」としてRepositoryに残すという運用 / カスタムのラベルやタグによって各スレッドを管理・検索できる"

2021/09/18 リンク

注目コメント算出アルゴリズムの一部にLINEヤフー株式会社の「建設的コメント順位付けモデルAPI」を使用しています

規約違反を報告

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

こんにちは。テクノロジー本部のyoshikawaです。好きなW3C Recommendation は RDF 1.1 Concepts and Abs... こんにちは。テクノロジー本部のyoshikawaです。好きなW3C Recommendation は RDF 1.1 Concepts and Abstract Syntax です。会議やチャットでのやり取りの決定事項・議事録、アプリケーションや機能の設計書・仕様書、READMEなどなど... LIFULLの開発現場においては、ソースコード以外にもこのように様々な文書の管理・蓄積(=ドキュメンテーション)を実施しています。多くの開発者・メンバーがドキュメンテーションの重要性やその恩恵は理解はしているものの、なかなかうまく情報の蓄積・管理ができない、その結果、本質的ではない調査に時間を取られてしまいDeveloper Experienceが下落してしまう。このような課題を抱えているプロジェクトやチームは世の開発現場において少なからず存在すると思います。 LIFULLの開発現場にもこの