プロジェクトのログまたは日記はどの程度役立ちますか？[閉まっている]

プロジェクトのログや日記を保存するのがどれほど難しい/役に立つか知りたいです。私がやったことを追跡するのに時間がかかりすぎるのではないかと心配しています...

私がやったことを追跡するのに時間がかかりすぎるのではないかと心配しています...

私は反対を心配しています。私はしばしば、何かを文書化しないことの費用が私の時間のさらに多くを消費することに気づきます。たぶん今日は起こらないでしょう。たぶん明日ではないかもしれませんが、ある時点で私がやったことの大部分はある時点で再び現れており、それは一般に、脳が重要でないと考えるのに十分な時間が経過した後に起こります。

したがって、私は物事を文書化します。特定の機能またはコード行のプロジェクトを簡単にgrepできるようにするためにキーワードを使用するだけでも、決定したこと、チームメンバーとの合意、および最も重要なことに、コードを文書化します。

場合によっては、ドキュメントによって他の人の時間も節約されます。X分の文書化がそれ自体への投資となり、X分の投資が時間の節約にY * X分の利益をもたらしたのは、こうした場合です！

最後に、他のケースでは、作業を文書化することで記憶に役立つことがわかりました。場合によっては、ドキュメントをもう一度見たことがありません。なぜなら、私にとって何かを書き留めることは、それを記憶に焼き付けるための触媒だからです。

誰もが違うので、自分に合ったものを見つける必要があります。私に関しては、自分の仕事を文書化するのに時間を費やしたことを後悔しているとは言えませんが、そうではない時間を後悔していることは確かです。

これは非常に一般的な質問ですが、答えは自己反省を見ることの価値に帰着すると思います。

進捗状況をメモするのに時間がかかる場合よりも、進捗状況を振り返る能力があなたにとってより価値がある場合、それは価値のある活動だと思います。

あるソフトウェアに取り組んでいるプログラマーとして、あなたが行った変更、どこで、そしてその理由を追跡するために、（バージョン管理ノートと同様に）進行状況と実行されたステップのログを持っているのは良いことだと思います。トラブルシューティングや同様のプロに取り組むときに非常に役立つ情報

そうは言っても、難しいことではありません。あなたが定期的にそれを行うことができれば、それはちょうどより便利です、そしてそれはほとんどの人々のためのルーチンに入ることによって支援されます。

3か月間お試しください。コミットして実行できるシンプルな形式を選択してください。それが利益を提供する場合、それを維持し、そうでない場合、それをドロップします。毎週、エントリの形式を確認し、必要に応じて調整します。

以下を試してください：

毎日の始めに書き留めてください

• すること（段落、スプレッドシート、好きなフォーム）
• どのような問題が発生すると予想されますか

毎日の終わりに書き留めてください

• あなたがしたこと
• あなたの邪魔になった障害
• 学んだ3つのこと（技術、非技術など）

毎週、レビュー

おそらく、毎日の開始時と終了時に5分かかります。毎週、自分に尋ねるものや気になったものを後で追加できます。書式を変更することを恐れないでください... 1週間で論文、次がWiki、3週目がトレロ スタイルに落ち着いて溝を見つけるには、1か月以上かかります。

それはよく費やされた時間です。私はすべてのメモをConnected Textというプログラムで管理しています。問題、会議、CYAアイテム、プログラミングノート、言語ノート、APIスニペットなどを参照します。また、Evernoteを使用してWebからのものをクリップし、ノートに変換します。キャリアで行うことの多くが再び出てくるので、これらの問題をどのように解決したかをメモしておくのは良い考えです。私はメモを参照できることを知って、重要なことを心に留めておくために、特徴点をオフロードするようなものだと考えています。結局のところ、それはあなたが最初にメモを取る理由です。

時間の無駄ではありません。

私は個人のウィキを約7年間使用しています。Wikion a StickまたはWoaS：http ://stickwiki.sourceforge.net/

私がサポートするすべてのソフトウェアのナレッジベース、多数の技術リソースへのリンク、チーム会議メモ-これらはすべて電話会議、開発環境の文書化、技術的および専門的な目標、todoリストなどを作成しました。このwikiにはメモ帳や付箋があります。http://portableapps.comからFirefoxを使用すると、wiki全体が自己完結型であり、サーバーを必要とせず、クライアントコンピューターにソフトウェアをインストールする必要もありません。クロスプラットフォームでも動作します。私が経験した唯一の問題はChromeの使用です。変更は保存されません。Firefoxが最高に機能したので、私はそれを使い続けます。

9か月後にプロジェクトを復活させるために、プロジェクトが何度も焼き戻されました。WoaSは私が中断したところに私を連れ戻し、以前に何をしたか、そのとき使用していたメモ帳に何が起こったのかを思い出そうとせずに生産的になりました。

時間をかけて自分の仕事を文書化したことを後悔したことはありません。練習を重ねた後、メモをとるのにそれほど時間はかかりません。シンプルでありながら情緒的なプロセスを開発できれば、それを行う可能性が高くなります。

それは文学です。

古代のように、知識は書かれたときに最もよく保存されていました。「口頭伝承」はそれほど効果的ではありません。

これは、成熟の兆候です。あなたの質問に答えるために：それは非常に便利です。将来、誰があなたの作品を読むつもりはありません。それは良い貢献です。

ここで、ログを保持することが重要な理由をいくつか説明します。

• 発明したものの特許を取得したい場合、ログブックは非常に重要な証拠になります。
• 非難の文化が存在する環境で仕事をしている場合、単に自分の裏側をカバーするために、自分が何をしたか、いつ、何を言ったかなどに注意する必要があります。
• すぐに探求する時間がない思考やアイデアを追跡したい場合は、ログブックは後でレビューするためにメモするのに適した場所です。
• 複数のプロジェクトで作業しており、プロジェクトコストを追跡したり、顧客に請求するためにタイムシートで作業の比較的詳細な会計が必要な場合、ログブックは時間を追跡する場所になります。
• チーム会議メモ、アジェンダなど。
• 合意、意見の不一致、決定、特にこれらの事態が発生した理由と方法は、情報が本当に必要な場合に実際の命を救うことができます。

ログブックの最後のページに書き終えるたびに、何年も前の古い本を振り返って、自分の知識がどこまで進んだか、私の考えがどのように変わったのかを見ることができます。特に転職を考えており、履歴書を本当に興味深いプロジェクトや成果でいっぱいにしたい場合は、自分の過去の仕事から学びましょう。

多くは、プロジェクトのサイズとプロジェクトの目標に依存します。小さなプロジェクトでは、Excelに物を置くことができます。再作業は最初に何かを正しく行うよりも時間がかかるので、後で時間を節約するために少し計画を立てる価値があることを忘れないでください。

リストで追跡すべきこと：

• 外部コミットメント、特に日付。

• 範囲-少なくとも高レベル。状況に応じて、これはより詳細になります。

• 依存関係-他から必要なもの。

• 問題、リスク、およびタスク

• あなたが費やす時間は何ですか（厳密さは、これが自己知識であるか外部請求であるかによって異なります）