プロジェクトのドキュメントまたはママは私に言った...

プロジェクト前のドキュメントに関するhabratopicを読んで議論した後、さまざまな種類の思考が頭の中に集まり始めました。 まず第一に、もちろん、私の趣味のプロジェクトJuffEdに関連しています。



叙情的な余談:

JuffEdプロジェクトは、「1.5年前のsipplus plusでのguiの書き方」に関する1つの討論で偶然に生まれました。また、クロスプラットフォーム。 JuffEdは、Qt4で記述された最も単純な機能と最も単純な構文強調表示を備えたエディターで、デモとして生まれました。 男は感銘を受け、教育のギャップに気づき、編集者はほとんど特別な場所に目立たず、どれだけ知らず、急いで行われたので、ほとんどダンプに送られましたが、彼らはそれを使用していることがわかりました。 少数、非常に少数の人々、文字通り少数、しかし楽しむ。 それは良かったので、私はそれをあきらめず、私の能力を最大限に引き出して、それが何をもたらすかを見ることにしました。




現在に戻ります。 2008年11月 現時点では、エディターは私が望むすべての機能を備えているわけではありませんが、新しい機能(および既存の機能の改善)に目を向けてソースコードをもう一度見て、私は落胆しました。 Hosspadi、hto、彼はこれを書いた、笑、あなたはここにいる、親愛なる、山盛り... = \



一般に、小さな再設計は成熟しています。 ほとんどのコンポーネントは本来どおりに機能しており、私がそれをどのように優雅に行ったかについてはまだ喜ばれていません(控えめですが、本当です:))。 そして、ここで、完全に疑問が生じました:「それで...どうすれば何ができるのかわからない場合、このビジネスをどのように再設計し(そして最も重要なことには、結果をテストします)?」おおよそ。 もちろん、メモリからすべての機能をリストするわけではありません。 また、リストにない場合、再設計後にすべてが機能するかどうかを確認することはできません。 そして、失敗すると、何かが確実に機能しなくなります。 そして、何かがうまくいかない場合、ユーザーは動揺します。 または、彼らは怒るでしょう。 ただし、悪意のあるユーザーは取得したいものではありません。



事件の理由は明らかです。 このプロジェクトは、「彼らは多くのことをした、うまくいくようだ」というシナリオに従って開発されました-「おっと、それは追加するものです」-「うわー、彼らは機能リクエストを送信しました! どんな問題をやろうか?」-「ああ、別の機能クエスト」-「ああ、バグレポート! それを修正しましょう”-“ああ、機能クエスト!” 私たちはそれをします。」-...そして、最終的には私たちが持っているものを手に入れました。 関数のリストでも、アーキテクチャの説明でも、何でもありません。 クラスでさえ本当にコメントされていません。 ユーザー文書はもちろん...



おそらくこれらの問題は多くの「ただの楽しみ」プロジェクトに典型的ですが、これは状況を変えることはありません。この特定のプロジェクトは、近い将来文書化の分野でさらに注意を払う必要があります。



All Articles