タグ

2023年3月25日のブックマーク (4件)

  • アジャイル開発で最低限作成したいドキュメント「ロゼッタストーンドキュメント」 - Qiita

    はじめに はじめまして株式会社ナイトレイの渡辺です。 この記事では、実際に弊社の開発チームが実践しているロゼッタストーンドキュメントについての概要と、書くべきドキュメントについての考え方などを記載します。 ロゼッタストーンドキュメントとは ロゼッタストーンドキュメントは(自分自身も含めた)未来のチームメンバーに向けて書く簡潔な手引書を指します。ソースコードやテストコードだけでは理解しづらい、開発対象システムの全体像の把握につながる情報を記します。 ちなみに、ロゼッタ・ストーンとは、エジプトのヒエログリフを理解する鍵となり、他の古代エジプト語の記録も解読が可能になったと言われているみたいです。 弊社が実際に書いている内容 弊社ナイトレイで実際に書いている内容は以下です。 ある程度の規模の機能単位ごとに作成しています。 システムの概要 担当者、リポジトリやサーバーの在処 システムの開発経緯 シ

    アジャイル開発で最低限作成したいドキュメント「ロゼッタストーンドキュメント」 - Qiita
  • システム開発文書品質研究会 - ASDoQ

    2024/11/1にASDoQ大会2024を名古屋大学を拠点にハイブリッドにて開催します. 2024/9/6-7にASDoQサマーワークショップ2024を開催します. 第34回研究会・2024年度総会を開催しました. システム開発文書品質モデルVer.2.0aをリリースしました. 第33回研究会を開催しました. ASDoQ大会2023の最優秀賞ポスターが企業のニュースで紹介されました. ASDoQ大会2023を開催しました. ASDoQサマーワークショップ2023を開催しました. 第32回研究会・2023年度定期総会を開催しました. 第31回研究会を開催しました. ASDoQブログ:第11回「山修の開発文書品質入門(11) --ユーザーストーリーを書く」を掲載しました. ASDoQブログ:第10回「山修の開発文書品質入門(10) --要求テンプレートの構成」を掲載しました. 「誤読されない

  • Mermaid 入門してみたメモ(flowchart で力尽きた…)

    GitHubMarkdown の中に Mermaid を埋め込んだら表示してくれる機能がバレンタイン デーにリリースされました。 今まで Mermaid は知らなくて、テキストでアクティビティ図やクラス図みたいなものを書く必要があるときは PlantUML を使ってましたが GitHub が対応したということで Mermaid に入門してみようと思います。 因みに、この記事を書き始めた時点では、まだ何もやっていないので Mermaid については名前と図が書けるらしいということしか知りません。 では、やってみようと思います。 試すための環境 Visual Studio Code の Markdown Preview Mermaid Support を入れることで Markdown のプレビュー機能が Mermaid のプレビューに対応します。 導入前はこんな感じですが 拡張機能を入れ

    Mermaid 入門してみたメモ(flowchart で力尽きた…)
  • とってもやさしいフロントエンド入門

    まず、新しいアイデアが提案されると、ステージ0の「Strawman」と呼ばれる段階に入ります。ステージ0のアイデアが価値のある提案として見なされ、大まかな形で問題点や解決策を説明できるようになると、ステージ1の「Proposal」と呼ばれる段階に進みます。そして、提案がある程度まとまって仕様の草案として認められると、ステージ2の「Draft」と呼ばれる段階に上がります。さらに細かいところまで練り上げられて、仕様がほぼ完成した状態になると、ステージ3の「Candidate」の段階になります。最後に、2つ以上のブラウザがその機能を実装していて、ECMAScript の編集者に承認されると、ステージ4の「Finished」と呼ばれる段階になります。 ステージ4に上がった提案は、毎年 6 月のタイミングで ECMAScript の新しいバージョンとしてリリースされます。リリースする際は、ECMAS

    とってもやさしいフロントエンド入門