紙のドキュメントの取り扱い[終了]

Question

新しいプログラムを作成するたびに、多くの紙のドキュメントが残ります。

プログラマーからの通常の落書きメモとは別に、通常、物理モデルの説明、計算など（方程式、表、グラフ、変数を説明する小さな写真など）を含む素晴らしい書類の山があります

私たちは通常、コンソールアプリケーションで数値集中計算を行いますが、これは一般には公開されていません（家に残り、結果のみが出ます）。各プロジェクトが完了する前に、それらのすべての書類を何らかの形でアプリケーションに詰め込む必要があるため、いつか誰かがその一部を再利用するときに、そこに何が入っているのかをある程度知ることができます。 これまで、すべてをスキャンして、アプリケーションと共にディスクにパックする「ダーティ」ソリューションを使用してきました。

だから私は疑問に思っていました...ここにいるすべての科学者にとって、同様の状況で...必要であるが公開されていないプロジェクト文書をどのように扱いますか？ （そうするものはdtpの仲間に行き、彼らはそれを素敵で光沢のあるものにします-もう私たちの問題ではありません：）

Answer 1

次の3つのオプションのいずれかを使用します。

• 低レベルのもののために、自分がアーカイブしたラボノートにすべてを保管します
• 紙の文書をスキャンし、pdfのソース管理に追加します。いですが、誰かがそれを必要とするなら、それはそこにあります
• 方程式、結果などを将来の参照用にクリーンな形式（通常はLatex）で書き起こし、ソース管理に追加します。公式の紙のコピーが署名され（私は高度に規制されたドメインで働いています）、バインダーに提出されます。

Answer 2

私が取り組んでいるプロジェクトでは、プログラムで多くの物理計算を行っているため、作業中の方程式を含むホワイトボードセッションがたくさんあります。

主要なプロジェクトごとにウィキを保持し、ホワイトボードセッションごとにホワイトボードをデジタルカメラで物理的に撮影し、ウィキ内でアップロード/整理します。また、重要な場合は開発者のノートブックから紙の文書をスキャンし、Wikiにも含めます。

その後、保存用にディスク上のウィキをバックアップします。したがって、私たちのソリューションは、組織化にプロジェクトwikiを使用することを除いて、あなたのものにかなり似ています。

Answer 3

重要な場合は、公開ドキュメントを扱うのと同じ注意で内部ドキュメントを扱うべきだと思われます。

Answer 4

アプリケーションのUIを設計するときにUIペーパープロトタイプを作成します。A3サイズのペーパーを大量に作成します（1つのプロジェクトでは、ペーパーで覆われた多くのデスクがありました）。デザインの準備ができたとき、または誰かに郵送する必要があるときは、デジタルカメラで写真を撮り、UIでいくつかのタスクを実行する方法を示す一連の写真を作成します。アプリケーションは動作することを意図しています。これは、誰かが元の紙を盗んだりきれいにしたりする場合のバックアップとしても機能します。

Answer 5

ここにいくつかの考えがあります...しかしあまり実用的ではありません：）

1. チェックインノートの一部にすることができます。これは、開発者がアプリケーションを保守するのに役立つ場合があります。
2. これらの項目で要件文書/低レベル設計文書を更新します