タグ

あとで読むと技術に関するXenosのブックマーク (2)

  • 技術文書の書き方

    howto-tech-docs.md 技術文書の書き方 このメモは、私(@ymmt2005)が長年にわたってソフトウェアプロダクト開発に関わってきて 2022年現在こうしたほうが良いと考えているベストプラクティスです。 科学的な分析等に基づくわけではない経験則であるため、今後も随時見直すことがありますし、 ここに書いてあることが常に正しいわけでもあらゆるソフトウェア開発に適するわけでもありません。 しかしながら、実務経験が豊富で、モダンな技術スタックに明るいエンジニアの経験則は一定の 役に立つのではないかと考えて記します。 技術文書とは ここでは、ソフトウェア開発で技術者が書くべき文書ということにします。 ソフトウェアエンジニアにも役割がいろいろあり、アーキテクトと independent contributor では書く文書が違うということはあるでしょうけれど、ここではごっちゃにします。

    技術文書の書き方
  • 特許庁の「標準技術集」がおもしろい - モジログ

    特許庁 標準技術集 http://www.jpo.go.jp/shiryou/s_sonota/hyoujun_gijutsu.htm 特許庁のサイトで、「標準技術集」という面白いページを見つけた。<論文、マニュアル、カタログ、webページ等の非特許文献に記載された、開発されて間もない新しい技術等を技術分野(テーマ)ごとに収集した>ものらしい。 このページの基的な趣旨は、特許の出願希望者に対して、「これらは公開済みなので、特許にならないですよ」という教育目的のようだ。しかし特許とは関係なく、コンテンツとして実に面白い。幅広い産業分野について、かなり踏み込んだ技術解説になっているのだ。 例えばIT関連だと、「電子・ネット広告」、「サーチエンジン」、「クライアント上の情報セキュリティ技術」、「コンピュータグラフィックス(アニメーション)」といったものがある。 このそれぞれに、1冊のくらいの

  • 1