• Twitterでシェア
  • Facebookでシェア

ドキュメントの限界 - orangeitems’s diary

テクノロジー カテゴリーの変更を依頼 記事元:www.orangeitems.com
適切な情報に変更
147users がブックマーク コメント 19
    共有

    • 記事へのコメント19件

    • 注目コメント
    • 新着コメント
    その他
    hagane
    IaCがドキュメント、というのはわかりつつ、意外とバージョンの縛りであるとか、コマンドで渡す時にオプション付けないと、とかはあるので、更新も欠かせないし、ドキュメントもReadme程度であっても必要なんだよな

    その他
    TakamoriTarou
    どちらかというと、設定や構築の方がAI化されて、ドキュメントとか客先にプロの仕事だと認識させるとか、納得させる方の仕事ばかりが残る気はする。

    その他
    turanukimaru
    いやそのための Infrastructure as Code だと思うのだが。環境を再構築するドキュメントの書き起こし辛すぎるから一体化させてるわけで。お客さんが納得するかは…設定全部コメントアウトされてるテンプレートでも付けとく？

    その他
    gcyn
    タイトルから連想される反論をどうでもよくさせる、「そのスジでいえばその通りの感想になるだろうなあ」っていう素直な感じの文章でしたよ。素直なものを読める楽しさってある。

    その他
    yoiIT
    大抵の場合そんなのは大した「ノウハウ」じゃない。そういうのを気にしてドキュメント作ってるから非効率なんだと思う。＞“流出したくないので、なんとなく仕事をした感を出すため、設定を全部洗い顧客に提供する”

    その他
    dorapon2000
    “一番いいのは、製品側でドキュメントが自動生成されるようになること。それができたら夢のようだよね。リリース前に、ドキュメントを自動生成してくれて、それで終わり。”

    その他
    yosio_ism
    cloudformationテンプレートとかterraformのtfを読み込んで納品版ドキュメントを吐き出してくれるようなやつが欲しいよね。

    その他
    nemoba
    限界なのは、ドキュメントじゃなくて、請負開発やろって話

    その他
    degucho
    あとから知りたいのは「なんでそうなったか」の経緯の方なのに現状説明資料になっててメンテナンスが発生するの不毛なんよ

    その他
    tomei10
    顧客次第だけど、IaCは素人がパッと見て、なんのリソースがどれくらい作成されて、どんなパラメーターなのか判断できないから、ドキュメントとしては扱われない。

    その他
    gcyn
    gcyn タイトルから連想される反論をどうでもよくさせる、「そのスジでいえばその通りの感想になるだろうなあ」っていう素直な感じの文章でしたよ。素直なものを読める楽しさってある。

    2023/06/09 リンク

    その他
    masatomo-m
    コードがドキュメントの大部分の役割を果たすということはあれど、そもそもなんのツール使ってるか（バージョン含む）とか、どのディレクトリに何があるかくらいはREADMEに書いておいてほしいとは思うかな

    その他
    ducktoon
    ドキュメントを顧客に提出したらドキュメントはいらないので安くしてくれと言われたことはある

    その他
    TakamoriTarou
    TakamoriTarou どちらかというと、設定や構築の方がAI化されて、ドキュメントとか客先にプロの仕事だと認識させるとか、納得させる方の仕事ばかりが残る気はする。

    2023/06/09 リンク

    その他
    yarumato
    “IT関連ソフトウェアは複雑に。設定は多くはデフォルト値。設定変更したものだけドキュメント化すると「仕事これだけ？」質問がくる。仕事をした感を出すため、全設定をドキュメント化するが不毛な作業だ”

    その他
    earu
    IaCとかフレームワークも前提知識は増えてる印象はある

    その他
    yoiIT
    yoiIT 大抵の場合そんなのは大した「ノウハウ」じゃない。そういうのを気にしてドキュメント作ってるから非効率なんだと思う。＞“流出したくないので、なんとなく仕事をした感を出すため、設定を全部洗い顧客に提供する”

    2023/06/09 リンク

    その他
    n314
    ドキュメント代も請求に含んで、結構高め（稼働実費）にしたら無しになったりする。タダならそりゃ欲しい。有りでも有料ならそれはそれで良い。

    その他
    strawberryhunter
    弊社では基本的にドキュメントの納品は自動生成でできる範囲にして手作業で作らずに済むように契約している。保守に必要な情報は内部で別途。お気持ちへの配慮も必要なのかなあ。

    その他
    a-know
    “何を作ったかを示すドキュメントとセットで初めて、プロにお金を払って仕事をしてもらった気持ちになる。”

    その他
    hagane
    hagane IaCがドキュメント、というのはわかりつつ、意外とバージョンの縛りであるとか、コマンドで渡す時にオプション付けないと、とかはあるので、更新も欠かせないし、ドキュメントもReadme程度であっても必要なんだよな

    2023/06/08 リンク

    その他
    cpw
    コードがドキュメント。もちろん、補助するための資料は必要だけど。AIでっていうかもしれないけど、自然言語で(A and B) or (B and (C or D))みたいなのを表現するのマジ無理。

    その他
    turanukimaru
    turanukimaru いやそのための Infrastructure as Code だと思うのだが。環境を再構築するドキュメントの書き起こし辛すぎるから一体化させてるわけで。お客さんが納得するかは…設定全部コメントアウトされてるテンプレートでも付けとく？

    2023/06/08 リンク

    その他

    注目コメント算出アルゴリズムの一部にLINEヤフー株式会社の「建設的コメント順位付けモデルAPI」を使用しています

    アプリのスクリーンショット
    いまの話題をアプリでチェック！
    • バナー広告なし
    • ミュート機能あり
    • ダークモード搭載
    アプリをダウンロード

    関連記事

    ドキュメントの限界 - orangeitems’s diary

    インフラの環境構築を行ったときに、はい、環境です、と接続情報だけ顧客に提供したところで、そのまま...

    ブックマークしたユーザー

    すべてのユーザーの
    詳細を表示します

    同じサイトの新着

    同じサイトの新着をもっと読む

    いま人気の記事

    いま人気の記事をもっと読む

    いま人気の記事 - テクノロジー

    いま人気の記事 - テクノロジーをもっと読む

    新着記事 - テクノロジー

    新着記事 - テクノロジーをもっと読む

    同時期にブックマークされた記事

    いま人気の記事 - 企業メディア

    企業メディアをもっと読む

    はてなブックマーク

    公式Twitter

    はてなのサービス

    • App Storeからダウンロード
    • Google Playで手に入れよう
    Copyright © 2005-2025 Hatena. All Rights Reserved.