タグ

仕事と文書に関するt-murachiのブックマーク (4)

  • いまこそ「良い仕様書」がチームの生産性の鍵となる。ので、仕様書に含めたい 14 のポイントについてまとめました。|Fritz | Lead Product Manager @ Mercari

    いまこそ「良い仕様書」がチームの生産性の鍵となる。ので、仕様書に含めたい 14 のポイントについてまとめました。 こんにちは、フリッツ です。今回はプロダクトマネージャーの日課とも言える「仕様書」について。自分にとっては PM 業の施策実行フェーズにおいて最も重要な仕事のひとつであり、最も心躍り、最も興奮する瞬間です。 PM になってかなりの時間が経ちましたが、「仕様書」への力の入れようは減るどころか、「もっと気合を入れなければ。」と感じる一方。在宅勤務が(たぶん) IT 業界のニュースタンダードとなっていくいま、なおさら「仕様書」の重要性を訴えたい今日この頃です。 ということで、今回は ・ 良い仕様書がもたらす 5 つの効果 ・ 仕様書の重要性が増していく 2 つの理由 ・ 仕様書に含めたい 14 の項目・実戦編 ・ 仕様書作成時に心に留めたい 3 つのこと ・ 具体的な仕様書サンプル(

    いまこそ「良い仕様書」がチームの生産性の鍵となる。ので、仕様書に含めたい 14 のポイントについてまとめました。|Fritz | Lead Product Manager @ Mercari
    t-murachi
    t-murachi 2020/07/21
    ??? issue 単位でやり取りされる開発関連情報を纏めたものを「仕様書」と呼んでおられる? プロジェクトの全容を見渡すものではなく? でもそれってそれこそ ITS の役割じゃね?
  • 「誰が書いても同じコード」は大事なことなのか - ひがやすを技術ブログ

    昨日、大手SIerの方々と話をする機会があって、そこで出てきたのが、「誰が書いても同じコード」になることが重要で、それを実現するために、ドキュメントをいっぱい書かなくてはいけないという話。大手SIerは、大体同じことを考えていると思います。 でも、「誰が書いても同じコード」にするってのは、そもそも無理だと思うんだよね。そうやって、わざわざドキュメントをたくさん書かせても、めためたなコードを書くやつはいて、総合テストするときに、現場は燃え上がるもの。ある程度の規模以上のプロジェクトなら、どこでもそんな感じじゃないかと思います。 重要なのは、「誰でもメンテナンスできるコード」にすること。そのために、コーディング規約は、きちんと決めてみんなで守る、それ以上は、がちがちに縛る必要はない。 がちがちに縛るために、設定ファイルをたくさん書かせたり、必要以上のドキュメントを書かせるのは、一定の品質を確保

    「誰が書いても同じコード」は大事なことなのか - ひがやすを技術ブログ
    t-murachi
    t-murachi 2008/03/27
    必要以上のドキュメントは要らないと思う。末端の解釈をかえって混乱させるだけだし。(多分そういう話じゃないw) / つか、ドキュメント書く側もどの程度の文書が必要なのか分かってないケースが多いんでね?
  • Matzに聞いてみた:効率の良い開発についてどうお考えでしょう? - builder by ZDNet Japan

    曖昧になる技術の境界線 ウェブエンジニアを取り巻く状況は混沌としている。まずは知っておかなければ行けない分野が飛躍的に増えている。HTMLCSSJavaScriptはもちろん、ときにはRubyまでもやらなければいけない、さらにはデータベース(DB)のことも知っておかなければならない、といった具合だ。 さらには、どこからどこまでをどの技術でやるべきかという見極めも難しい。たとえば、Ajaxアプリケーションを作る際、JavaScriptを使ってフロント側で処理するのか、バックエンドでRubyで処理するのか、あるいはどこまでをバックエンドで処理すべきなのか。どこからどこまでをJavaScriptですればいいのか。そうした技術の境界は、どこにあると見るべきなのか。ウェブ開発の分野では、技術の境界が曖昧になっているのである。 この“曖昧になる技術の境界”に対して、Ruby開発者であるまつもとゆき

    Matzに聞いてみた:効率の良い開発についてどうお考えでしょう? - builder by ZDNet Japan
    t-murachi
    t-murachi 2008/02/19
    メンテナンサーが変わるたびにソースを一から追わなきゃいけない。それが今後の Web 開発のジャスティス。穴があったら弄りたくなるはまちちゃんの気持も分かるってもんだよまったく。
  • 東大で学んだ卒論の書き方★論文の書き方

    卒業論文の書き方を詳説

    t-murachi
    t-murachi 2008/01/09
    「代筆屋さん」の話は最近追記されたもの?
  • 1