フューチャーアーキテクト Advent Calendar 2017の2日目です。 はじめに システム設計が大好きで大嫌いな皆さん、こんにちは。 突然ですが、皆さんはどのようにシステム設計における ドキュメント腐る問題 に立ち向かっていますか？ ドキュメント腐る問題とは、設計時に作成した各種ドキュメントがGoogle Driveやファイルサーバ上で陳腐化してしまい、現状の正しい状態を指していないことです。せっかく新規参画者がキャッチアップしようとしてもドキュメントが真実を示していないという怖いやつですよね。 解決策としては、各種ドキュメントを、MarkdownやAsciiDoc、UMLはPlantUMLやmermaid、ERDはPlantUMLやerd、画面遷移図はUI Flow、REST-API設計はSwaggerなど、なるべくテキストベースで管理し、GitHubなどのリポジトリで管理する
criminal_jc.md criminal_jc.plantuml ph�� @startuml !define SenmonName 誤認逮捕された専門学校生 !define CriminalName 犯罪中学生 !define RakusatsuName 落札者 !define JK2Name 女子高生と社会人の2人 !define TicketShopName チケット転売サイト participant "SenmonName" as Senmon participant "CriminalName" as Criminal participant "JK2Name" as JK_2 participant "TicketShopName" as TicketShop participant "RakusatsuName" as Rakusatsu participant "警察
1
リリース、障害情報などのサービスのお知らせ
最新の人気エントリーの配信
処理を実行中です
j次のブックマーク
k前のブックマーク
lあとで読む
eコメント一覧を開く
oページを開く
