設計ドキュメント腐る問題、Git管理で運用してみた結果 | フューチャー技術ブログ
はじめにTIG真野です。 秋のブログ週間2023 の3本目は、設計ドキュメントをGit管理して腐らせないようにがんばってみた話をします。 前段として6年前、「我々はいかにシステム開発におけるドキュメント腐る問題と戦えば良いのか」という記事を書いたのですが、その後の試行錯誤はどこにも残していないことに気づきました。普段のフューチャー技術ブログですとちょっと引け目を感じるテーマですが、秋の夜長を楽しむため読み物成分を多めに書くというテーマのこのブログリレーにピッタリな気がするため、この機会をお借りします。 ドキュメントも色々な種別があるかと思いますが、この記事では設計ドキュメントを指すことにします。設計ドキュメントは開発メンバーが参照するもので、ステークホルダーへの説明資料に引用して使うことはあれど、主目的は異なるという前提です。Design Docの場合もありますし、システム構成図、ERD、
GoogleのDesign Docsから学ぶソフトウェア設計 - Qiita
概要 Design Documentと聞くと何を想像しますか？ 一般的にDesign Documentが指すのは設計書であることが多いのではないでしょうか。 設計書、簡単に説明するのであればソフトウェアを「どうやって作るの？」を説明したドキュメントです。 Googleではソフトウェアエンジニアリング文化における重要な要素として、今回お話ししていくDesign Docsと呼ばれるものがあります。 Design Docsとは？ Design Docsとは、開発者がコーディングに着手する前にソフトウェアシステムまたはアプリケーションの開発する人が作成するドキュメントです。 => ソフトウェア設計における仕様書や設計書とは別物と捉えた方がよいです。 仕様書、設計書は作成した上でのDesign Docsの作成となるようです。 このドキュメントには、高レベルの実装戦略と主な設計の決定事項がまとめられて
詳細設計書（前半）
前回までに表1の? 7「機能設計書」の基本設計ドキュメントとして、「表紙」「I/O関連図」「画面レイアウト」「帳票レイアウト」について紹介しました。今回からは、詳細設計に関するドキュメントについて順に説明していきます。 "機能"単位での設計書 機能設計書は、機能単位でドキュメントが作成されます。例えば、「プロスペクト登録画面」と「プロスペクト一覧画面」と「プロスペクト一覧表」という3つの機能があれば、3セットの機能設計書を作ることになります。ここで注意して欲しいのは、設計書の記述はあくまでもユーザのイメージする"機能"単位で、プログラミング単位の"プロシージャ"や"クラス"ではないということです。この"機能"という概念について、図1「プロスペクト登録画面」を例に説明しましょう。 図1を見ると、「プロスペクト登録画面」という機能は、画面、イベント、BL（ビジネスロジック）などのオブジェクトか
オープンソース開発ツールドキュメントの紹介
テレビでCMをやっているような大手消費者金融ならともかく、 あまり名前を知られていない業者はきちんとした会社なのかどうかわかりづらいですよね。 最近の闇金はツイッターやＦＡＣＥＢＯＯＫなどＳＮＳを使った勧誘が多いです。 電話の対応も良かったから、とよく調べないで借りてしまったら実は闇金だった！ と後から大変なことになります。 借りようとしている業者が闇金なのかどうか調べる方法としては、 「登録貸金業者情報検索入力ページ」というものがあります。 貸金業を営むには、必ず都道府県知事や財務局長への登録が必要になりますので、登録している業者であればこの検索で引っかかってくるはずです。 登録番号、所在地、会社名、代表者名などを入れる欄がありますが、どれかひとつを入力しただけでも該当するものがあれば出てきますので、 業者の商号しかわからないという場合でも検索することができます。 厄介なのは、正規の登録
|アップデイティット株式会社|update it, Inc.|
探す、書く、直す、レビューするなど、ドキュメント開発を効率化する 『crossnote』 データを集め、検証し、文書化し、配布する一連のプロセスを自動化する 『EDITROOM』 2024/3/29crossnote ver 2.1.8リリースサーバー・リポジトリに対するファイルの直接操作機能等 2023/12/27crossnote ver 2.1.7リリースPDFファイルの比較機能、IPアドレスの制限機能、ルビの表示など 2023/10/13crossnote ver 2.1.6リリースpluginのバージョンの集中監視、イメージ比較、セキュリティ対応等 2023/06/30crossnote ver 2.1.5リリースDocFlow - SQLデータベースやElasticsearch対応、チャート対応など 2023/04/05(Wed) - 2023/04/07(Fri)Japan
update it, Inc. 社長のブログ
2024年3月29日に定期バージョンアップとして、 crossnote / EDITROOM ver 2.1.8をリリースしました。今回のバージョンアップではプロジェクトをセットアップしていなくてもサーバー・リポジトリに対して直接ファイルやフォルダを修正できるようになりました。またcrossnote内でファイルのコピーを行う際、置き換えができるようになりました。 (1) サーバー・リポジトリに対するファイルの直接操作ができます crossnoteでは通常、ファイルやフォルダを修正する場合、プロジェクトをセットアップしてから手元（ワークスペース上）で修正を行い、修正結果をサーバーにコミットする、という使い方をします。 通常のcrossnoteの使い方 １．まず、あらかじめ利用するプロジェクトをセットアップします。これによりサーバー・リポジトリからプロジェクトのファイル一式がPCにダウンロード
Google Japan Blog: 日本のデベロッパーの要望に応え、多くの技術ドキュメントを日本語化しました
メディア関係者向けお問い合わせ先 メールでのお問い合わせ: pr-jp@google.com メディア関係者以外からのお問い合わせにはお答えいたしかねます。 その他すべてのお問い合わせにつきましては、ヘルプセンターをご覧ください。
1
リリース、障害情報などのサービスのお知らせ
最新の人気エントリーの配信
j次のブックマーク
k前のブックマーク
lあとで読む
eコメント一覧を開く
oページを開く
基本設計書
Java 暗号化拡張機能 JDK5.0
Oracle Java Technologies | Oracle