StackEdit – In-browser Markdown editor
Rich Markdown editor StackEdit’s Markdown syntax highlighting is unique. The refined text formatting of the editor helps you visualize the final rendering of your files. WYSIWYG controls StackEdit provides very handy formatting buttons and shortcuts, thanks to PageDown, the WYSIWYG-style Markdown editor used by Stack Overflow. Smart layout Whether you write, you review, you comment… StackEdit's la
作図系ツール・ライブラリまとめ
diag.md シーケンス図とかフローチャートをしごとで描画することになった場合、 テキストから生成できたら楽なので、それ系のツールまとめ GraphViz http://www.graphviz.org/ C製 Doxygen, Moinmoinなどと連携可能 ブロック図、クラス図、ネットワーク図など PNG, SVGなど 出力可能形式一覧 JavaScript（Emscripten）版もある。リアルタイムプレビュー出来て便利 https://github.com/mdaines/viz.js PlantUML Java製 シーケンス図, ユースケース図, クラス図, アクティビティ図, コンポーネント図, ステート図, デプロイ図, オブジェクト図などめっちゃたくさん作れる PNG, SVG, LaTeX, ASCII出力 なんとワイヤーフレームも作れる。アイコンとかも入れられる。 オ
詳細設計書も問題だけど、それ以上に成果物定義が問題 - プロマネブログ
詳細設計書という名のゴミ | Gm7add9 この手の話題が定期的に上がるわけですけど、毎度同じだよねで終わってしまっては人間進歩しないので、何が問題でどうすればよいのか少し考えてみたく。 詳細設計書は「プログラム説明書」として欲しい。 まあ、元記事も多分業務システムの受託の話の模様なのでSIをターゲットに。 往々にしてSI、特にウォーターフォール開発のプロジェクトの中では、設計書などのドキュメントを多数作成いたします。*1 V字モデル的には、設計から開発に至るまでの間 要件定義書 基本設計書・外部設計書 基本設計書・内部設計書 詳細設計書 プログラム みたいな成果物を作成いたします。 個別の詳細は別のサイトに任せるとして、それぞれ記載する内容を一言で表すと、要件定義書は「スタートとゴール」、外部設計書は「業務とサービスの仕様」、内部設計書は「サービスの構造と機能の分割」となります。 ※た
仕様書とかをgithubで管理してから、半年ちょとでどうなったか - longicornの日記
風邪を引いてそろそろ3週間目にはいりそうです。つらい。 さて、以前こういう事を書いていた。 その後予想通りデスマになって、落ち着いてのでこの挑戦がどうなったか振り返ってみようと思う。 2014-03-10 - longicornの日記 2014-03-24 - longicornの日記 当時はどんな状態だったか? まず、当時は周りを見渡しても仕様書なんかまったく作られないそんな状態だった。 エンジニアすら、そんなの必要ないとかまで言っていた状態。 夢物語を書いた物はあったけど、みんな知識はないしでも忙しすぎて動けない状態だったので、最低でも自分の所属しているプロジェクトだけでも自分で初めて見た結果です。 どうなったか? ドキュメント まず、以前書いたとおり仕様書を含むドキュメントは基本githubにあげています。 もちろん仕事なので、有料にしてprivateにしています。 デスマには陥りま
Excelなテスト仕様書をMarkdown/GitHub/CircleCIに移行した話 - トレタ開発者ブログ
こんにちは、QAエンジニアの井上恵一です。好きな飲み物は一番搾りと韃靼そば茶です。 初回からニッチなネタではありますが、昨年入社した直後に行った、 iPad アプリのテスト仕様書の管理方法を見直したときの話を紹介しようと思います。 見直しのきっかけ トレタは飲食店向けの予約/顧客台帳アプリです。だれでもかんたんに使いこなせるシンプルさを追求してはいますが、製品の進化に伴ってそのテストケース数はすでに数千という単位にまで膨れあがっています。 製品の品質を安定させるためには、テストの内容自体をブラッシュアップすることが重要なのは言うまでもありません。ただ、安定した製品を永続的に提供していくためには、それに加えて、膨大なテストケースを効率よくメンテナンスし続けるためのプロセス作りも欠かせません。 入社のタイミングでトレタのテスト設計を担当することになったので、テストケースの管理方法についてもいち
API仕様書をMarkDownで書き、GitHubをつかって運用する方法 | ランサーズ（Lancers）エンジニアブログ
追記 2018/06/05 すぐに試せるサンプルリポジトリ作ったので、使って見てください。 https://github.com/TsuyoshiNumano/api_document_sample 生成されるドキュメント 開発サーバーを立ててリクエストする例 こんにちは、tsuyoshiです。 API仕様書の作成や、その運用。皆さんはどうやっていますか？ 現在自分が所属するチームでは、以下のツールを使って API をドキュメント形式で書いて管理しています。 - api blue print： APIドキュメントを MarkDown で記述する言語 - aglio： APIドキュメントをHTML化するツール - api-mock(新しいnode.jsで動かない) drakov: APIドキュメントをモックサーバ化するツール API仕様書をドキュメントで管理することで、API仕様書をGitH
リリース、障害情報などのサービスのお知らせ
最新の人気エントリーの配信
j次のブックマーク
k前のブックマーク
lあとで読む
eコメント一覧を開く
oページを開く
GithubのREADMEにのせる画像の置き場所 - 素材の味
Private Site