読みやすいREADMEを書く | Yakst
いくつかのオープンソースプロジェクトを公開している筆者からの、読みやすくユーザーにやさしいREADMEを書くためのアドバイス。 この記事は、Rowan Manning氏による「Writing a Friendly README」(2016/3/14)を翻訳したものです。 あなたのプロジェクトのREADMEは、かなり重要です。そこはプロジェクトに初めて来た人が大抵最初に見るであろう場所であり、唯一のドキュメントであることもよくあります。あなたのオープンソースプロジェクトにとってのREADMEは、企業にとってのウェブサイトのようなものです。ウェブサイトはユーザーエクスペリエンスの注目を集めるところですが、READMEがユーザー観点で考えられることはほとんどありません。 この記事では、分かりやすいREADMEを書くために役立ち、開発者(ユーザー)の要求に見合い、開発者がプロジェクトを初めて見たの
ディレクターがエンジニアと仕事をする時、やってはいけない7つのこと - paiza times
Picture by ITエンジニアを目指す女子高生たちの学園ライフ4コマ漫画『ぱいじょ！』 こんにちは、谷口です。 ディレクターやプロジェクトマネージャー、営業といった職種の方々は、企画やプロジェクトを進めるために、エンジニアとのコミュニケーションが必須です。そんな中で、エンジニアとのコミュニケーションに難しさやギャップを感じた経験がある方も多いのではないでしょうか。 実際、エンジニアには口下手な人やコミュニケーションが苦手な人もいます。加えて、不満やコミュニケーションエラーが積み重なったとき、彼らの大半は黙って辞めていきます。 辞めていく人たちは、いちいち「何が不満だったのか」なんて教えてくれません。しかし、非エンジニア職としては「どこが悪かったのかわからない」ままですから、また次のプロジェクトで同じパターンが繰り返される…といったことも起こりがちです。 paizaはエンジニア向けの転
なぜプロジェクトは炎上するのか？炎上しやすい4つの傾向と、炎上を防ぐ3つの対策 - paiza開発日誌
Picture by ITエンジニアを目指す女子高生たちの学園ライフ4コマ漫画『ぱいじょ！』 こんにちは、谷口です。 某Mずほ銀行の案件のニュースが出たとき、弊社でも結構話題になりました。 あんなに巨大なプロジェクトをしずめるのは、もう本当に不可能なんじゃないかと思いますが、どんなに大きな炎上も、恐らくは小さな火種が集まって、やがて大きな炎となってしまった結果だと思いますし、最初の小さな火種の段階からぷちぷち消していけたらこんな結果にはならなかったはず……。 という話をしていたときに、paizaのエンジニアが「かつて炎上しているプロジェクトに自ら突入していくのが趣味だった」などと言い出しました。「そういう性癖なのかな」と思ったんですが、聞いてみると 「炎上しているプロジェクトに行くと『優秀な人たちはどんな振る舞いや働きをして炎上をしずめているのか』『何が原因で炎上したのか、どの時点で何をし
開発に便利なタスクランナー「gulp」で出来る事、導入方法などをまとめました ｜https://wp.yat-net.com/name
2015年 09月 10日 開発に便利なタスクランナー「gulp」で出来る事、導入方法などをまとめました カテゴリ： gulp タグ：gulpタスクランナー タスクランナーの一つであるgulp（ガルプ）。使い出すとすごく便利で今ちょっと手放せない開発ツールの一つなんですが、使ってない人からすると、導入コストとか学習コストが気になって、まだ手を出してないという方もいますよね。なので、今回導入用の記事を書いたので、ちょっと気になってるという方、試してみたかったという方に役立てばいいなと思います。 1.タスクランナーとは？ gulpで何ができるのか？ 2.gulpに必要な環境を整える – Node.jsのインストール 3.gulpに必要な環境を整える – package.jsonの作成 4.gulpに必要な環境を整える – gulpfile.jsの作成 5.gulp-ejsを使った開発環境 6.
【家庭にプロジェクト管理ツールを導入して1ヶ月】実感した5つの変化 - Mana Blog Next
はじめに 結果 プラスに変わったこと Before (Backlog導入前) (1)寝不足と、モチベーション低下との闘い (2)やることが多すぎて日が暮れていた After (Backlog導入後の5つの変化) (1)期限を設定することにより気持ちが楽になった (2)情報共有による時間の節約ができた 引き継ぎしやすい (3)以前よりも子どもと向き合えるようになった BacklogのWikiは議事録としても秀逸 (4)育児以外のタスクに時間を掛けないようになった (5)夫婦の雑談が増えたことによって、新しいアイディアが生まれた プロジェクト管理ツールはこれからも継続使用します はじめに 我が家では1ヶ月ほど前にプロジェクト管理ツールを導入しました。 当初の宣言通り、まずは1ヶ月間 Backlogを導入し、家庭内のタスクが滞りなくスムーズに対応できるかどうか試してみることにしました。 今回は、
TodoistとEvernoteでつくるフリースタイルな仕事環境
仕事を管理するのにきっちりとしたプロジェクト管理のツールを使うのもよいのですが、もう少しあいまいで、何でもフリースタイルで書き込むことができるほうが性に合っているというひともいるでしょう。 たとえるなら、一枚の大きな紙です。 きっちりとしたリポート用紙に仕事にまつわるタスクやメモを書き込んでゆくよりも、えいっと大きな紙にその場に必要なことを書き込みながら、時には乱暴に消したり上書きしながら仕事を進めるほうがいいということはよくあると思います。 こうした仕事環境をデジタルで作ることができるかが一つの挑戦なのですが、ここでも「人生の仕事場」へと舵を切ったEvernoteが答えを出しています。 それが本家Evernoteブログで紹介されていた、TodoistとEvernoteを使ったこんな方法です。 シンプルが最強な Todoist と Evernote Todoistは私もここ１年ほどメインで
今まで経験したプロジェクトでありがちな展開と、エンジニアとしてアウトプットしていくパターン - mizchi's blog
なんか最近、(比較的)アウトプットしてないな、とふと気づいたんだけど、よく考えたらプロジェクトの進捗のフェーズによってアウトプットの分量が偏るのはいつものことだなー、とも思った。 それらのフェーズを前期、中期、後期、運営期で考えみる。 初期段階 おそらくライブラリの選定段階から始まる。この時期のアウトプットは、いわゆる「やってみた系」の記事が増える。ウェブに出る記事だと、これが大多数をしめる。汎用性が高く、技術的に挑戦的なものが多い。(立場的な話をするとQiitaはそういう記事がたくさん共有されると助かる) 選定が終わった段階で、アーキテクト的な役割の人は、たぶんこうあるべきだ、みたいな思想を形成する。それをクラス図やコード規約や役割に応じたドメイン特化基底クラスとして表現したりする。DDD的なアレならこれをユビキタス言語の構築としてプロジェクトを通してやるべきなんだろう。 使う予定のフレ
発注者として最低最悪、公共機関のシステムをどうするのか
システム開発において発注者責任の自覚やその能力が無く、丸投げしかできないにもかかわらず、お客様は神様であることを信じて疑わず、買い叩くことだけに血道を上げる。しかも開発プロジェクトの最中に要件はどんどん膨らむが、追加料金は出さないし、納期厳守も要求。当然プロジェクトは破綻を来すが、その責任の全てをITベンダーに押し付ける。 こんな危ない客がいたら、ITベンダーはその開発案件を取りに行くだろうか。普通はスルーだ。諸般の事情で商談に参加しなくていけなくなったとしても、“法外な”高値を提示するなどして、間違っても受注しないように努力するだろう。そもそも今どき、そんなとんでもない客がいるのか。それが、いるのである。官公庁をはじめとする公共機関だ。 公共機関だとすると、冒頭に書いた客としての振る舞いは、その多くが「とんでもない」ではなく正当な行為となる。公共系システムは国民・住民からの税金などで作る
フリーで使えるガントチャートテンプレート一覧｜IT情報局
この記事では、エクセルで作成されたガントチャートテンプレートを無料でダウンロードできるサイトを厳選して紹介します。 ガントチャートは、会社でプロジェクトをスケジュールどおりに遂行する場合に作成するスケジュール管理表です。 しかし、ガントチャートを使ってプロジェクトのスケジュール管理をする場合、会社に決まったフォーマットがない場合は自分で０から作らなくてはなりません。 ガントチャートを０から作るのも大変ですよね。素早く楽に作成するには、使い勝手のよいテンプレートを自分で改良するのが一番です。 以下では多くのサイトを紹介しているので、ぜひ自分のプロジェクトに合いそうなガントチャートテンプレートを見つけてください。 <関連する記事> 要求仕様書の書き方やテンプレートが見れるサイトまとめ タイムスケジュール表 無料エクセルテンプレート エクセルで作成したガントチャートを無料配布しているサイト一覧で
1
リリース、障害情報などのサービスのお知らせ
最新の人気エントリーの配信
j次のブックマーク
k前のブックマーク
lあとで読む
eコメント一覧を開く
oページを開く
https://blog.shinji.asia/sourcetree_git/