設計ドキュメント腐る問題、Git管理で運用してみた結果 | フューチャー技術ブログ

2023/11/01 66 users Git管理 前段 フューチャー技術ブログ 結果 試行錯誤

はじめにTIG真野です。 秋のブログ週間2023 の3本目は、設計ドキュメントをGit管理して腐らせないようにがんばってみた話をします。 前段として6年前、「我々はいかにシステム開発におけるドキュメント腐る問題と戦えば良いのか」という記事を書いたのですが、その後の試行錯誤はどこにも残していないことに気づきました... 続きを読む

markdownlintで設計書の品質を高める | フューチャー技術ブログ

2023/04/17 125 users GitLab Markdown GitHub フロー ツール

はじめにフューチャー技術ブログのリレー形式の連載である、春の入門祭り2023の1日目です。TIG真野です。 ここ数年、Markdownで設計書をチームで書き、GitHub（GitLab）上でレビューするフローを採用しています。なるべくテキストベースで設計開発フローを統一するため、私の所属するチームでは以下のようなツールを採用... 続きを読む