タグ

documentに関するlamichのブックマーク (78)

  • A4-2 日本電気通信システム 杉田様

    テスト設計書を書こう! - 抜け漏れのないテスト設計書テンプレートの提案 - テスト設計書を書こう! - 抜け漏れのないテスト設計書テンプレートの提案 - NEC SWQCテスト技術コミュニティ 杉田 正実(日電気通信システム株式会社) 吉澤 千佳子(日電気株式会社) © NEC Corporation 2009 Page 2 SWQCテスト技術コミュニティの紹介(1) NECグループのSWQC活動として、テーマ別コミュニティ活動中! テスト技術コミュニティは、特にソフトウェアテストに興味を持った メンバーで構成されています。 SWQC活動:NECにおけるソフトウェアの総合的品質管理活動(1981年に開始) 現在は組織を超えてSW開発技術者が切磋琢磨する場として活動中 © NEC Corporation 2009 Page 3 SWQCテスト技術コミュニティの紹介(2) 活動状況とメン

  • ゲームの仕様書を書こうまとめ

    ゲームの仕様書を初めて作成する人のための足掛かりのスライド ▼以下のスライドを一つにまとめました ・ゲームの仕様書を書こう1 仕様書作成の分業とリストの作成 https://www.slideshare.net/ChizuruSugimoto/ss-173331109 ・ゲームの仕様書を書こう2 仕様書に記載する機能内容 https://www.slideshare.net/ChizuruSugimoto/ss-173332578 ・ゲームの仕様書を書こう3 仕様書に記載するデータと画面 https://www.slideshare.net/ChizuruSugimoto/ss-173333150 ・ゲームの仕様書を書こう4 仕様書作成で楽をするconfluenceの活用 https://www.slideshare.net/ChizuruSugimoto/confluence-17333

    ゲームの仕様書を書こうまとめ
  • 顧客が本当に必要だったものとは (コキャクガホントウニヒツヨウダッタモノとは) [単語記事] - ニコニコ大百科

    顧客が当に必要だったもの単語 ニコニコ動画で顧客が当に必要だっ…の動画を見に行く コキャクガホントウニヒツヨウダッタモノ 7.7千文字の記事 194 0pt ほめる 掲示板へ 記事編集 概要それぞれの絵が意味するところどうすればよかったのか?ニコニコ動画:Zero に置き換えてみると関連動画関連項目掲示板 このプランは必ずや御社のITビジネスに多大なる成功をもたらすベストソリューションとなることをお約束いたします。 この記事は第198回今週のオススメ記事に選ばれました!(2012年4月3日) よりニコニコできるような記事に編集していきましょう。 概要 「顧客が当に必要だったもの」とは、ITビジネスにおける多難なシステム開発プロジェクトの姿を風刺した絵に登場する、オチの部分のフレーズ。顧客が期待した通りのシステムとして完成しなかった原因は、開発側の勝手な思い込みや都合の押し付けだと思い

    顧客が本当に必要だったものとは (コキャクガホントウニヒツヨウダッタモノとは) [単語記事] - ニコニコ大百科
  • サンプル例に見る機能仕様書の基本的な書き方&読みやすくする7つのテクニック (1/3):プロジェクト成功確率向上の近道とは?(2) - @IT

    サンプル例に見る機能仕様書の基的な書き方&読みやすくする7つのテクニック:プロジェクト成功確率向上の近道とは?(2)(1/3 ページ) ITシステム開発の問題点の一つであるコミュニケーションの失敗。連載では、これを防ぐ方法としてお勧めしたい3つのドキュメントを紹介していく。今回は、Joelの機能仕様書を日人向けにカスタマイズされたものを例に、機能仕様書の基的な書き方、読みやすくする7つのテクニック、仕様書作成ツールは何を使うべきか、誰が書くべきかなども解説します。 連載目次 連載の第1回の前回「ドキュメントは最強のコミュニケーションツールである――Joelの機能仕様書入門」では、ITシステム開発がビジネスに貢献していくためには、まずは開発の成功が出発点になること、そしてITシステム開発におけるコミュニケーションの重要性、そしてコミュニケーションにおけるドキュメントの重要性について説

    サンプル例に見る機能仕様書の基本的な書き方&読みやすくする7つのテクニック (1/3):プロジェクト成功確率向上の近道とは?(2) - @IT
  • ドキュメントは最強のコミュニケーションツールである――Joelの機能仕様書入門

    ドキュメントは最強のコミュニケーションツールである――Joelの機能仕様書入門:プロジェクト成功確率向上の近道とは?(1)(1/2 ページ) ITシステム開発の問題点の一つであるコミュニケーションの失敗。連載では、これを防ぐ方法としてお勧めしたい3つのドキュメントを紹介していく。今回は「Joelの機能仕様書」のポイントを解説する。 連載目次 はじめに 連載では、ITシステム開発がビジネスに貢献していくために必要な、最も基的な条件である“システム開発の成功”につながるいくつかのポイントを紹介します。 筆者は、さまざまなコンピューターシステム開発に長年携わってきたソフトウェア技術者ですが、この連載では、あえて技術的ではない話題を中心に述べます。というのも、技術論だけではシステム開発が成功する条件としては不十分ですし、すでにたくさんの優れた技術論が各方面で展開されています。あらためてそこ

    ドキュメントは最強のコミュニケーションツールである――Joelの機能仕様書入門
  • https://www.nic.ad.jp/ja/materials/iw/2011/proceedings/t3/t3-01.pdf

  • ソフトウェアの運用保守フェーズでまず用意すべきドキュメントリスト - ぱと隊長日誌

    はじめに ソフトウェアの開発は厳しい工数管理と納期に迫られます。その中でドキュメントはしばしば削減対象となります。ただ、ドキュメントを削減したツケは運用保守フェーズで払うことになります。コードを見ればわかる?サーバ構成なんて調べればわかる?問い合わせや障害の調査時に訳も分からずコードとサーバをひっかきまわしながら同じことを言えますか? 今回のエントリでは運用保守の担当としてこんなドキュメントがほしかった・あってよかった…という一覧をまとめました。 なお、今回のエントリはまだまだ改善の余地があると考えています。今後の自身の経験や周囲の意見などを取り入れながら、継続的に改善できればと考えています。 はじめに ドキュメントは何のために必要か? 運用ドキュメントの在り方 運用ドキュメントの管理 保存先 ファイル形式 差分の扱い 改定来歴をつける どのドキュメントから作るべきか? 運用保守で求められ

    ソフトウェアの運用保守フェーズでまず用意すべきドキュメントリスト - ぱと隊長日誌
  • http://www.takumistyle.net/style/contents/drop/part7/chapter30.html

  • 残業も減らせる!? 上級エンジニアになるためのDesign Doc超入門

    残業も減らせる!? 上級エンジニアになるためのDesign Doc超入門:プロジェクト成功確率向上の近道とは?(3)(1/3 ページ) ITシステム開発の問題点の一つであるコミュニケーションの失敗。連載では、これを防ぐ方法としてお勧めしたい3つのドキュメントを紹介していく。今回は、「技術視点」のドキュメントとして、2000年代以降注目されている「Design Doc」について解説します。 IT技術がビジネスに貢献していくためには、まずはシステム開発を成功させることが重要です。連載「プロジェクト成功確率向上の近道とは?」では、システム開発を成功させるために、コミュニケーションが果たす役割の重要性と、ドキュメントによるコミュニケーションの重要性について解説してきました。 連載1回の「ドキュメントは最強のコミュニケーションツールである――Joelの機能仕様書入門」、第2回の「サンプル例に見る

    残業も減らせる!? 上級エンジニアになるためのDesign Doc超入門
  • ドキュメント作成時のあるあるアンチパターン20 - Qiita

    業務でドキュメントを作成するケースは多々ある 例:仕様書・設計書・提案書・メール・障害票... ここでは各ドキュメント共通してありがちなアンチパターンをまとめてみました。 1. 表記がバイト表示・マイクロ秒表示 プログラムが出した数値をありのままに表示するパターン ファイルサイズが100MB, 1GBあろうと、バイト表示にする 桁数が多い数値に、桁区切り(,)を入れない 時間を何でもマイクロ秒・ミリ秒にする(1/100万秒までの精度が必要?体感で分かる?) 桁数が多い=精度が高い=良い文書、ではなく、見る人が必要とする精度に切り上げることが重要(売上で1円単位まで出すことが無いのと同様) 悪い例 No ファイル名 ファイルサイズ(byte) 処理時間(秒)

    ドキュメント作成時のあるあるアンチパターン20 - Qiita
  • 文書ドリブン開発 テスト文書編

    開発現場は日々の仕事の場であるとともに、学びの場でもある。先輩エンジニアが過去に直面した困難の数々、そこから学んだスキルや考え方を紹介する。 システム開発プロジェクトで作成される文書にフォーカスしての連載の最終回です。今回はテスト関連文書について考えたいと思います。なお、以下の記述はあくまで筆者の私見であることをあらかじめお断りしておきます。 最初の仕事はテスト仕様書作り わたしがシステム開発業界に入って間もなく配属されたプロジェクトで、最初に作った文書は単体テスト仕様書でした。初めての現場に配属されて期待と緊張の渦巻く中での作業です。いきなり先輩社員に見限られたりすることのないように少ない知識で精いっぱい取り組んだことをいまでもよく覚えています。しかし、そんな思いとは裏腹に、まったくもって作業は進みませんでした。いま思えばそれほど難しくもない機能の単体テスト仕様書作りに丸1日かけ、やっと

    文書ドリブン開発 テスト文書編
  • 文書ドリブン開発 詳細設計文書編

    開発現場は日々の仕事の場であるとともに、学びの場でもある。先輩エンジニアが過去に直面した困難の数々、そこから学んだスキルや考え方を紹介する。 システム開発プロジェクトで作成される文書にフォーカスしての連載の第4回です。今回は詳細設計文書について考えたいと思います。特に詳細設計文書のレビュー者の視点にスコープすることで、「指摘される個所が少ない」詳細設計文書の作成ができるようになることを目指します。なお、以下の記述はあくまで筆者の私見であることをあらかじめおことわりしておきます。 レビュー者としての特殊スキル 先日同僚と詳細設計文書のレビューというテーマについて話をしました。彼は「レビューをした際に設計の怪しい部分とそうでない部分が感覚的に識別できる」といっていました。実はわたしも不思議なことに、詳細設計文書を斜め読みしただけで、設計のバグや実装上で問題になりそうな部分が感覚的につかみ取れる

    文書ドリブン開発 詳細設計文書編
  • 文書ドリブン開発 DB設計文書編

    開発現場は日々の仕事の場であるとともに、学びの場でもある。先輩エンジニアが過去に直面した困難の数々、そこから学んだスキルや考え方を紹介する。 システム開発プロジェクトにて作成される文書にフォーカスしての連載の第3回です。今回はDB(データベース)設計文書について考えたいと思います。なお、以下は筆者の私見であることをあらかじめおことわりしておきます。また、特に指定のない場合、稿で指すDBとはRDBのことです。 高いプレッシャーと闘うDB設計者 大半のシステム開発プロジェクトには、DB設計者としての役割を持つ方が専任・兼任の差はあれアサインされていると思います。わたしが考えるに、DB設計者は中堅からベテランのSEが担当されているケースが大半です。これはシステム開発においてDB設計の難解さと重要さが認識されているためですが、DB設計者の立場というのはその責任の重さの割には軽視されていると思える

    文書ドリブン開発 DB設計文書編
  • 基本設計文書の質を下げる「4つの心理バイアス」

    開発現場は日々の仕事の場であるとともに、学びの場でもある。先輩エンジニアが過去に直面した困難の数々、そこから学んだスキルや考え方を紹介する。 前回「当は楽しいドキュメント作成」に引き続き、システム開発プロジェクトで作成される文書にフォーカスします。 今回は基設計文書について考えたいと思います。なお、以下の内容は筆者の私見であることをあらかじめお断りしておきます。 基設計文書の品質を下げる要素とは 基設計工程では、文書作りに対して、その完成度を下げるための「負の心理バイアス」がかかると考えています。文書作りの際、文書の量と質を下げようとする意識が働くのではないかということです。 基設計文書の完成度を下げる「負の心理バイアス」にはさまざまなものがあります。わたしは、下記の4つが代表的なものだと考えています。 ユーザーとの検討に関するバイアス 開発手順に関するバイアス 文書用途の理解不

    基本設計文書の質を下げる「4つの心理バイアス」
  • 我々はいかにシステム開発におけるドキュメント腐る問題と戦えば良いのか

    フューチャーアーキテクト Advent Calendar 2017 の2日目です。 システム設計が大好きで大嫌いな皆さん、こんにちは。 突然ですが、皆さんはどのようにシステム設計における ドキュメント腐る問題 に立ち向かっていますか? … ドキュメント腐る問題とは、設計時に作成した各種ドキュメントがGoogle Driveやファイルサーバ上で陳腐化してしまい、現状の正しい状態を指していないことです。せっかく新規参画者がキャッチアップしようとしてもドキュメントが真実を示していないという怖いやつですよね。 今まで出会った一番辛いドキュメントは、PJ初期に作成したホワイトボードに書かれたラフスケッチの画像しか無かったところですね。まず字が汚いし、内容も最新版と微妙に異なっていました。新規参画者殺しにもほどがあると、ほんのちょっとだけ恨みました。 いやいや、ちゃんとサボらず整合性を取れよって?サボ

    我々はいかにシステム開発におけるドキュメント腐る問題と戦えば良いのか
  • 本当は楽しいドキュメント作成

    開発現場は日々の仕事の場であるとともに、学びの場でもある。先輩エンジニアが過去に直面した困難の数々、そこから学んだスキルや考え方を紹介する。 文書作りは好きですか? 今回からこの連載を担当いたします、アクセンチュア・テクノロジー・ソリューションズの宮和洋です。 システム開発プロジェクトでは、さまざまな文書が作られます。私の連載ではこの文書に注目し、「文書ドリブン開発」という考え方を紹介したいと思います。 文書ドリブン開発は私の造語です。「文書が作成されることにより、具体的な開発作業が進行していく」ことを意図しています。 多くのITエンジニアは、文書作りではなく、動くものを作ることに楽しさを見いだすと思います。その作業の楽しさの中には、システムの設計に悩み、動作実証実験を繰り返す楽しさも含まれているのではないでしょうか。「この仕組みでちゃんと動くかな~、どうかな~」と試してみることが、ワク

    本当は楽しいドキュメント作成
  • REST APIドキュメント作成ツールはapiary.ioが決定版かもしれない - Qiita

    背景 APIドキュメントを書くのが楽になるツールまとめ - Qiita iodocsで便利なREST APIドキュメントを作成する - Qiita これまでずっとREST APIドキュメントをwiki上で管理していて、重たいページ上で特殊記法使ったり、スタイルの調整に時間を取られるのが辛かった。そこで良さげなドキュメントツールを色々調べてたんだけど、最終的にapiary.ioが一番良さそうという結論になってきた。 このサービスの主な特徴。 markdown記法でAPIドキュメントを記述できる ドキュメントの生成と同時にAPIのモックサーバを用意してくれる サインアップから5分くらいあればドキュメント公開できる。ドキュメントのホスト先を気にしなくてもいい。 特にドキュメントと一緒にモックを作ってくれるのは他にはないポイントでかなり便利。 使ってみる サインアップはGithubアカウントで h

    REST APIドキュメント作成ツールはapiary.ioが決定版かもしれない - Qiita
  • 第14章 - Admin ジェネレーター | 日本Symfonyユーザー会

    第14章 - Admin ジェネレーター 多くのアプリケーションはデータベースに保存されたデータに基づいており、それにアクセスするためのインターフェイスを提供します。symfony は Propel または Doctrine オブジェクトに基づいたデータ操作機能を提供するモジュール作成の反復タスクを自動化します。オブジェクトモデルが適切に定義したのであれば、symfony はサイト全体の管理機能 (アドミニストレーション) も自動的に生成します。この章では、Propel プラグインと Doctrine プラグインに搭載された Admin ジェネレーターをお教えします。これは完全な構文による特別な設定ファイルに依存するので、この章の多くは Admin ジェネレーターのさまざまな可能性について説明します。 モデルをもとにコードを生成する Webアプリケーションにおいて、データアクセスオペレーシ

  • 日本語ドキュメント - Apple Developer

    語ドキュメント 日語に翻訳されたiOS/watchOS/tvOSのドキュメントです。 英語版の方が新しい場合がありますので、更新日を確認して下さい。 エンタープライズ環境での運用に関するドキュメントはこちらに移動しました。 App Store Connect ヘルプ タイトル 日付

  • フロントページ - Solr Wiki