タグ

designとプログラミングに関するtxmx5のブックマーク (2)

  • 技術文書の書き方

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

    技術文書の書き方
  • デザイナがエンジニアリング(プログラム)を学ぶコツ | fladdict

    最近、色々な方と「表現とエンジニアリングの融合」について、お話を伺ったりしたことからのまとめ。 なぜ表現者はテクノロジーを学習するのが苦手か 表現とエンジニアリングができるハイブリッドな製作者は、理系あるいはエンジニア出身の人間が多い。逆にアーティストや(グラフィック)デザイナーのバックグラウンドから、ハイブリッド型へと移行する人は相対的に少ない。 基的には、エンジニアのほうが「系統立てて学習する」という点で、ノウハウと教育がある。いわゆる「美的センス」といわれるようなモノであっても、いちどロジック化して自分なりに消化さえできてしまえば、エンジニアは表現やデザインもエンジニアリングの一貫として学習することができる。(逆に、スキルをブレイクダウンして学習するぶん、「作れるけど作りたいものがない」になりがちではある。) 明確なビジョンが学習を阻害する 一方アーティストやデザイナが、なぜテクノ

  • 1