skillup

技術ブログ

「 ドキュメント作成 」 一覧

no image

ディレクション時に重要な視点

ディレクション(ベンダーや内製時)時に留意するポイント 開発ルールの構築 シンプルかつ有効性高いルール 少ないチェックリスト(多いと形骸化する資料が増える) 個人の意思に頼らない仕組み うまいテンプレ …

no image

テスト分類について

一般的なテスト工程での分類や個人的に大事だと思うこと 全プロセス共通 テストデータ作成バッチ 状態の復元を容易にするために必要なテストデータを簡単に作れる機能があると便利 ローカル、開発、ステージング …

no image

障害報告などでの伝える情報の視点

障害の重要度(後続タスクにブロックがあるかいなか)、調査原因(仕様不理解、設計考慮もれ、ケアレスミス)、影響度(画面単位などで) 障害が起こっているデータ(あるいはスクショなどで伝えられるか) 再現プ …

no image

Gitの活用に関して

2021/01/02   -Git, ドキュメント作成

今回はgitの技術的なことではなく、主に運用に関して。超基礎的なことですが、チームで開発する場合にはルールを徹底してないと混乱をきたします。 ブランチを追加機能ごとにきる 当たり前ですが、featur …

no image

単体テスト仕様書について

おそらく開発者が書きたくないものの筆頭になるかと思う単体テスト仕様書ですが、うまく使うと有益なコミニケーションツールになります。 ユーザーのフロー体験・説明書 プロジェクトに入ったばかりですと仕様がわ …

no image

Officeソフトで覚えておきたいポイント(Word,Excel)

えー実は今現在、仕事でコードを書くことはほとんどしておらず、ExcelやWordと日々格闘しております。Excelも表計算じゃなくて図を書くのに使ってます。 ExcelはまだしもWordってエンジニア …

no image

仕様の把握で見るポイント

新しい現場に入って技術的な部分はもとより仕様の把握などでポイントになる点などを。 ER図 あればまずそのER図を使えば良いですし、なければ作っていくと理解が進むことが多いです。 ポイントとしては意味の …

no image

使える設計書作成に関して シーケンス図

使える仕様書ですが、細かいロジックなどシーケンス図も結構役に立つのでは・・と思いましたね。 シーケンス図とは下記のようなものです。 https://cacoo.com/ja/blog/what-is- …

no image

使える設計書作成に関して

私自身、この仕事を7〜8年やっておりますが、設計書作成については常に悩まされておりました。 設計書のメリット・デメリットとしては以下のようなものですかね。 メリット メンバー間での仕様の認識を統一でき …

no image

新しいプロジェクトに入った時にやること

新しいプロジェクトに入った時に最初にすべきことややっておくことなど 仕様理解編 基本ですが、見落としがないように紙の資料は必ず印刷して考えること。文房具として消すことのできる色ペンがあるとさらに便利。 …