2021年6月5日のブックマーク (2件)

  • プログラマーがドキュメントを書かない理由

    この記事は、著者の許可を得て配信しています。 Why programmers don’t write documentation 最近ではずっとコードのドキュメンテーションに関連した記事を書いていたので、当然、私のMediumのおすすめ記事には「開発者がドキュメントを書かない当の理由」という記事が表示されるようになりました。この記事では、ドキュメントを書くための優れたツールがないことが、ソフトウェアエンジニアが自分の作業や判断をドキュメンテーションする意欲を失わせる最大の原因について書いています。 私は普段、特定の記事を批判したりはしませんが、この記事には怒りを覚えました。このライターは図解ツールについていくつかメリットに関して述べてはいますが、全体的に誤解を招くような内容になっており、この重要な問題をより分かりにくくさせています。2つの図解ツールを比較して、どちらも不十分なツールである

    プログラマーがドキュメントを書かない理由
    Amigomr
    Amigomr 2021/06/05
    「ドキュメント」の定義がわからんが、設計書もなく(あってもメンテされておらず)、コードにコメントも一切ない状態で、過去のコミットログやチケットから経緯を探る考古学的作業を減らすべきというなら同意する
  • 苦労して採用したエンジニアにすぐ転職されるのはなぜだろう - paiza times

    Photo by Medialab Prado こんにちは。谷口です。 ITエンジニアの採用活動って難しいですよね。自社の開発チームを大きくするため、採用活動で苦労されている人事担当の方も多いかと思います。 paizaは転職・就職のサービスなので、採用担当の方から「採用活動に力を入れたい」「エンジニアを増やしたい」というご相談を受ける機会は非常に多くあります。 ただ、採用を増やすのはもちろん重要なのですが、肝心の「今いるエンジニア退職せず自社にい続けられること」にも目を向けなければ、いつまでたっても開発チームを大きくすることはできません。 というわけで今回は、エンジニアがなぜ転職してしまうのか、エンジニア転職を招く要因についてお話しします。 エンジニアが辞めるのは悪いことではない、ただ… エンジニア転職自体は、何も悪いことではありません。 エンジニアに限った話ではありませんが、誰だっ

    苦労して採用したエンジニアにすぐ転職されるのはなぜだろう - paiza times
    Amigomr
    Amigomr 2021/06/05
    こういうのはもう言い尽くされていて、むしろなんでこれを受け入れられないのかという観点で考えてみたいところ....