githubに関するmarin72_comのブックマーク (2)

  • エンジニアの立ち居振舞いについての知見を集めていきたい - hitode909の日記

    普段,エンジニアの暮らしというとコードを書いているイメージだけど,実際には,1日8時間のうち2〜3時間しかコードを書けていなかったりする. 実際にはエンジニアはふだん何をしているのか,こういうことを気をつけている,とか,今日の1日はこういう形でした,といった立ち居振舞いを集めて,知見として集めていきたい. ということで,エンジニア立ち居振舞いのお題を作りました. お題「エンジニア立ち居振舞い」 せっかくなので1つ紹介して終わろうと思います. 立ち居振舞い:GitHubの通知を全部見る 僕はチーム内では長い期間在籍しているエンジニアで,一日中GitHubの通知を見ている. GitHubで通知が来るということは,誰かが仕事を進めたということで,何か質問を書いたり,方針を書いていたり,コードをpushしたり,いろんなことを誰かが進めている. そういうときに,そのissueにとって役立ちそうなこと

    エンジニアの立ち居振舞いについての知見を集めていきたい - hitode909の日記
  • 読みやすいREADMEを書く | Yakst

    いくつかのオープンソースプロジェクトを公開している筆者からの、読みやすくユーザーにやさしいREADMEを書くためのアドバイス。 この記事は、Rowan Manning氏による「Writing a Friendly README」(2016/3/14)を翻訳したものです。 あなたのプロジェクトのREADMEは、かなり重要です。そこはプロジェクトに初めて来た人が大抵最初に見るであろう場所であり、唯一のドキュメントであることもよくあります。あなたのオープンソースプロジェクトにとってのREADMEは、企業にとってのウェブサイトのようなものです。ウェブサイトはユーザーエクスペリエンスの注目を集めるところですが、READMEがユーザー観点で考えられることはほとんどありません。 この記事では、分かりやすいREADMEを書くために役立ち、開発者(ユーザー)の要求に見合い、開発者がプロジェクトを初めて見たの

    読みやすいREADMEを書く | Yakst
  • 1