タグ

@ITに関するLatのブックマーク (1)

  • SIerの書くドキュメントの品質管理:ヒエログリフ -エンジニア版-:エンジニアライフ

    つい最近、ドキュメントを書いていてふと思いました。いったいこのドキュメントの品質はどのくらいのものを目指して作られているのだろうかと。だいたいどこのプロジェクトでもドキュメントをどう書くかという指針のドキュメントがあると思います。ただ、そのドキュメント自体がExcel方眼紙で読みにくいというのがほとんどです。 品質の基準になるドキュメントの品質が悪いと、まともなドキュメントが書ける気がしません。相応に品質をもとめるのであれば、せめてドキュメントの指針くらいその手のプロに作ってもらったらどうかと思います。お客さんに出す成果物なので綺麗に仕上げたいと思うなら、ちゃんとお金を払ってキチンとしたものを作れるようにしたらいいと思います。 もしこれがへっぽこ大企業ではなく、ちゃんと工夫を惜しまない会社が作ったら、校正はプロに任せてエンジニアは内容に集中するのかもしれません。校正を頼むといっても、あの程

    SIerの書くドキュメントの品質管理:ヒエログリフ -エンジニア版-:エンジニアライフ
    Lat
    Lat 2018/11/13
    ドキュメントの品質管理が顧客ごとに異なってはダメじゃない?ドキュメントの質については有償版のドキュメント自動生成ツールのサンプルを提示して契約前に了承を得るのが普通。それがダメなら仕事を受けたくないな
  • 1