タグ付けされた質問 「writing」

私は通常、プログラミング関連のものについて多くを読みます。私が読んだトピックが私の仕事に直接関連していない場合（日常の仕事では使用しないアルゴリズムについての読書など）、それらを忘れます。 学んだことを強化する1つの方法は、ブログを書くことです。私はブログを書く初心者です。書き始めたとき、私はそれが非常に難しいことがわかりました。単純にコンテンツを再生する場合でも、約2時間かかります。ブログについてよく考えて書くには、多くの場合、丸一日か週末がかかります。 これは正常ですか？技術的なチュートリアル/技術的なブログを書くためのヒントはありますか？

27 writing 

現在、機能および技術仕様を2列形式で作成しています。要約文と技術的詳細。詳細は、多くの場合、図、レイアウト設計などの付録を参照しています。 しかし、私はそれをどのように書くのに苦労しています： 過去の時制のように、作業が完了したかのように、既存の作業のハイライト拡張を示すのに苦労します。Xを行う必要があるため、将来の時制は、やることリストまたはTenseニュートラルのように聞こえます。 さらに混乱を加えるために、この仕様は、第一言語として英語を持っていない人々によって読まれるかもしれません。

21 documentation  specifications  writing 

だから私はここでスペックに関するジョエルの素晴らしい記事を読んだ。（2000年に書かれました!!）4つのパートすべてを読みましたが、仕様を書くための系統的なアプローチを探しています。 私は唯一の孤独な開発者で、非常に有名な金融会社のためにこのかなり複雑なアプリ（またはアプリのファミリー）に取り組んでいます。 私はこれほど深刻なことをしたことは一度もありませんでした。私は悪い仕様、ある種の概要のようなものを書き始め、それは私の時間の多くを無駄にしました。 また、クライアント用に3つのモックアップを作成したので、クライアントが何を望んでいるかをよく理解できます。また、プレビュー（最も基本的なワークフローを備えた使い捨てのアプリ）をリリースしました。私はコア/ベースシステムの一部のみを作成してテストしました。 私がこれまでに犯した間違いは、詳細な仕様を書くことではないのだと思うので、私は今それを達成しています。 したがって、全体は MVC Webサイト（管理者およびデータ表示用） 2つのSilverlightモジュール（2つの特定のタスク用） 1つのデスクトップアプリケーション 私は時間とリソースが完全に不足しており、これを迅速に行う必要があります。また、これらの人が同じように素早く、痛みを伴わずに読む必要があります。 それではどうやってやるのか、ヒントや現実の世界を探しているのですが、皆さんは通常どのようにやっていますか？ すべてのダイアログ/フォーム/ページの模擬スクリーニーを作成しますか？ ダミーのASP.NET Webフォームプロジェクトを作成し、フォルダーにHTMLファイルを入力して、MVC URL構造のように見せることを考えています。 次に、Webサイトの仕様にセクションを作成し、スクリーニーで取得したすべてのURLのページを作成します。 私の勝利フォームアプリケーションのために、私は、ややデモWinフォームプロジェクトで作られてきた私は考え、私と同じように、その後、実際のアプリでダイアログまたは構造のすべてに入れた後、画面はそれを撃ちましたか？ この質問の背景について。私はいつも夢中になってジャンプしてコードを作成していましたが、それはうまくいきましたが、私が取り組んでいるアプリにとっては、複雑であるだけでなく、非常に評判の高い大企業のためであり、それを手に入れなければなりません正しい！ （そして、それはこれまでのところ順調に進んでおり、今日私は多くの人が気に入ったプレビュー版のデモを行いました!! = D） 最初の設計を正しくすれば、この会社と素晴らしいビジネスをすることもできます。新しい「素晴らしい」機能についてはすでに多くの人が考えています。

17 writing  specifications  customer-relations 

現在のところ、この質問はQ＆A形式には適していません。回答は、事実、参考文献、または専門知識によってサポートされると予想されますが、この質問は、議論、議論、世論調査、または広範な議論を求める可能性があります。この質問を改善し、おそらく再開できると思われる場合は、ヘルプセンターをご覧ください。 8年前に閉鎖されました。 私はPeter SeibelのCoders at Workを読んでいますが、書くことができないプログラマーは一般的に貧しいプログラマーになるとよく言われています-ダグラス・クロックフォード、ジョシュア・ブロック、ジョー・アームストロング、ダイクストラ（そして私は本の半分しか読んでいない）。 これについてどう思いますか？英語などの自然言語で書くことで自分を表現できないことは、良いコードを書くことの妨げですか？

16 writing 

閉まっている。この質問はトピック外です。現在、回答を受け付けていません。 この質問を改善したいですか？ 質問を更新して、 Software Engineering Stack Exchangeのトピックになるようにします。 5年前に閉鎖されました。 私は書いたり説明したりするのが好きな奇妙な種類の開発者です-メール、仕様、あなたはそれに名前を付けます。私は人々が物事を深く理解するのを助けることを楽しんでいます。グループの25％が、筆者が自分の立場を半分しか説明していないか、急いで書き間違えた以前の途切れた電子メールを誤解したため、グループが30または40の電子メール、電話、会議を通過するピンポン通信が嫌いです批判的な言葉、または否定的な言葉を1つまたは2つ省いた。 この特性は文書化には最適ですが、私のメールは長いので、人々は単にそれらを読まないだけです。私が使用したいくつかの戦略は、長いメールを添付されたWord文書としてフォーマットして、人々がそれらをドキュメントとして見るように促すことです（時には驚くほどうまくいきます）、または自由な段落の代わりにもっと箇条書きを使用しようとします。これらの戦略は読者を増やしますが、コンテンツはまだ長いです。 もちろん、複雑な技術的なトピックには多くの説明と説明が必要であることを大声で叫びたいが、それは誰にも役立たない。明らかにできるトレードオフはありますが、明確ではない、または後に100万の質問、誤解、または追加の「条件」が追加されるステートメントの作成を正当化するのは困難です。 コミュニケーションを短く、しかし完全に保つにはどうすればよいですか？

12 communication  writing 

書き込みシステムが右から左である国々のプログラマーはどのようにコードを書きますか？彼らがC＃コンパイラを使用している場合、彼らは左から右へのアプローチに従っているか、または右から左へC＃コードを記述できる別のIDEを持っていますか？

8 coding-style  writing