ホーム
Top.Mail.Ru Yandeks.Metrika
フォーラム:「その他」;
現在のアーカイブ:2015.10.04;
ダウンロード:[xml.tar.bz2];

ダウン

本を読み書きする。 似ている枝を探す


Pavia ©   (2015-02-10 16:26) [0]

私はしばしば不器用な言葉に叱られます。 だから私はプログラミングに関する技術文書を上手に書きたいです。
どうやら最善の方法は、例から学ぶことです。
これについては、優れたスタイルと文法を備えた本やその他のドキュメントをアドバイスしてください。 まず、プログラムをテーマにしたドキュメントに関心があります。 第二に、技術文書。
誰かがフィクションについて意見を持っている場合、提案はまた開かれています。



Ega23 ©   (2015-02-10 16:57) [1]

スタイルが良ければ、サミズダットに目を向けると、グラマノフの初心者にはたくさんのものがあります。



Rouse_ ©   (2015-02-10 16:59) [2]

選択してください:)
http://rouse.drkb.ru/books.php



VICTOR_ ©   (2015-02-10 17:12) [3]

MSDN、Delphi 5ヘルプ



Германн ©   (2015-02-10 17:33) [4]


> MSDN、Delphi 5ヘルプ

うん。 特に機械翻訳でMSDNによって読み取り可能)



Pavia ©   (2015-02-10 18:50) [5]


>選択してください:)

選べたら。 私はアドバイスを求めません。 より具体的には1〜2冊の本に名前を付けることができます。 1〜2倍の著者。


>スタイルが良ければ、いくつかのsamizdatに目を向け、
>初心者のグラフォマノフのためのすべてがたくさんあります。

主にフィクションがあります。 そして科学的に人気があります。 これらのルールは技術文書に適用できると思いますか?
そして、私はまだ詳細が欲しい。

> VICTOR_©(10.02.15 17:12)[3]
> MSDN、Delphi 5ヘルプ

私はロシア語でする必要があると言うのを忘れていました。



Ega23 ©   (2015-02-10 19:36) [6]


>ほとんどがフィクションです。 そして科学的に人気があります。
>これらのルールは技術的に適用できると思いますか
>テキスト?


私は文学理論家ではありませんが、私の意見では、そのようなものはDivovのhezhをすり抜けました。 同様に、テキストを構築するための非常に明確なルールがあります。
記事を書く必要はありません-これは物理学者の冗談の別の章でした。
http://vivovoco.astronet.ru/VV/PAPERS/SCILANG/JOKE/JOKE2.HTM



Jeer ©   (2015-02-10 21:19) [7]

「本は文盲ではない。」

人々は文盲です。



Inovet ©   (2015-02-10 22:05) [8]

モデレータによって削除されました



Jeer ©   (2015-02-10 23:43) [9]

文芸本やスマート本は、そのような人々によって書かれています。



Inovet ©   (2015-02-11 00:11) [10]

モデレータによって削除されました



Kilkennycat ©   (2015-02-11 00:27) [11]

モデレータによって削除されました



Kilkennycat ©   (2015-02-11 00:30) [12]

モデレータによって削除されました



Кщд ©   (2015-02-11 09:46) [13]

>ジアー©(10.02.15 21:19)[7]
>「本は文盲ではない。」
http://ru.wiktionary.org/wiki/%D0%B3%D1%80%D0%B0%D0%BC%D0%BE%D1%82%D0%BD%D1%8B%D0%B9
引用:
"...文法および文体の誤りを含まず、文学言語の規範に対応◆これは有能なテキストの例です。
この知識分野の基本要件に従って作成されました◆ 最後に、有能な図面を作成することができました。」



Rouse_ ©   (2015-02-11 10:18) [14]


>パヴィア©(10.02.15 18:50)[5]
>
>>選択:)
>
>選択できれば。 私はアドバイスを求めません。 あなたはできる
>具体的には1〜2冊の本に名前を付けます。 1〜2倍の著者。

ええと、例えば、ドナルド・クヌース、全3巻:http://rouse.drkb.ru/books.php#knut



Pavia ©   (2015-02-11 10:39) [15]

むちとは思わない。 読んだ人は片手で数えることができるので。 残りは彼らが読んで習得しなかったことを正直に認めました。 そして、多くはそれを読むことさえせずに雄羊として助言します。 ヒントのXNUMXつは、各式が読者の数をXNUMX人減らすように聞こえる。 しかし、クヌートの表現スタイルもひどい。

1)条件番号1アンドリュー・タネンバウム。
2)しかし、XNUMX番目のダイクストラ、オクロフ、ワースは誰ですか?
3)あなたのオプション。



Kilkennycat ©   (2015-02-11 11:43) [16]

そして、外国の著者はいつオリジナルについて議論しますか? 翻訳者にとって、その翻訳者はまだそうかもしれません。



картман ©   (2015-02-11 12:13) [17]

私はここのスタイルが好きでした:http://elementy.ru/lib/431448



Kerk ©   (2015-02-11 12:26) [18]

Altshullerの「TRIZ入門」は、まったく素晴らしい言語で書かれています。

しかし、不器用な言葉はそもそもフィクションの正しい読み方です。 これはすべて言語の貧困によるものです。 私は、XNUMXつの単語を書くことができないかなり良いプログラマーを知っています。 これは明らかに彼らがタネンバウムを読んでいないという事実によるものではありません。 そして、それが翻訳であるならば、それを読むために言語を豊かにすることの意味は何ですか?



Юрий Зотов ©   (2015-02-11 13:56) [19]

>パヴィア©(10.02.15 16:26)

>優れた本やその他の文書をアドバイスしてください
>スタイルと文法。


まず第一に-プーシキン、チェーホフおよびそれらのような他の人。 なぜなら[18]。

数か月で具体的な結果を期待することはほとんど価値がありません。 たくさん読んでも、レキシコンはすぐには豊かになりません。 しかし、語彙に加えて問題があります-句の構成、句読点...

PS
そしてプーシキンとチェーホフの後-私の投稿。 最終研削用。
:O)



Kerk ©   (2015-02-11 14:11) [20]

ここで、ところで、私はhttp://www.flibusta.net/b/138618をお勧めします
まあ、それからすでにSWを投稿しています:)



pavel_guzhanov ©   (2015-02-11 14:12) [21]


>そして、プーシキンとチェーホフ-私の投稿の後。 決勝
>粉砕。


リンクを貼ることもできます。 私のサイトのみ; o)



Mystic ©   (2015-02-11 15:25) [22]

運動によって達成されました。 一般に、このトピックは非常に複雑です。

単語の使用が最善の選択肢ではない複雑なトピックを説明している可能性があります。 たとえば、チェスの本から表記全体を削除し、テキストのみを残した場合、ほとんどの作成者はそれを口に出します。 「キングサイドのルークポーンがフィールドに進み、司教を攻撃しました。 象はボードの端に立ってXNUMXつのフィールドに後退しました。 もちろん、そのようなジャンルの名手はいるでしょうが、数は少ないでしょう。 そのため、言葉が思い通りに表現されていないと感じた場合は、言葉以外のものについて考えることは理にかなっています。

それでも読者の希望を明確に理解する必要があります。 なぜ彼はあなたの原稿を読んでいるのですか? 何の答えを探していますか? たとえば、ほとんどの読者は、D。クヌートを開いたとき、なぜこれを行っているのか想像していません。 D.クヌートのスタイルは素晴らしく、問題は彼が解決する問題自体が非常に重要であることだけではありません。 加えて、今日、それらのソリューションに対する大きな実用的なニーズはありません。 データ構造? 通常、人はすでに既製のライブラリーのセットを持っています、そしてプロセッサーのパフォーマンスはそれを曲がって処理するのに十分です。 そして、誰かが自分の何かを台無しにした場合、一般的な場合では重要な解決策について話すので、コードの読みやすさについてのうなり声はすぐに消えます。 得られたアルゴリズムは、コプロセッサーの腸内で確実に実装されます。 ライブラリでは、並べ替えと検索も利用できます。 組み合わせ検索は、タスクでは頻繁に発生しません。

しかし、読者に戻る。 彼の代わりに自分を置き、「何が必要か」という質問をするのは便利です。 この質問に答える代わりに、読者がまったく別の質問への答えを見つけた場合、彼は期待に応えていないので、彼は舌に縛られているように見えます。 たとえば、詳細を気にせずに新しいプロセスを作成するには、CreateProcessを呼び出すだけです。 本の中で、彼が入りたくないパラメータの詳細な説明を見つけた場合、そのテキストは彼にとってひどく舌に結びついているように見えます。 彼が読むことを期待しているので:lpProcessAttributes-倒錯に興味がない場合は常にNULLを渡します。 代わりに、彼が必要としないSECURITY_ATTRIBUTESを使用することの複雑さについて読み始めた場合、彼が望んでいない詳細を調べると、ほとんどのフレーズは脳を通り過ぎてしまい、舌の緊張感を高めます。 著者のように、理解できないごみを書きます。



Jeer ©   (2015-02-11 17:08) [23]

Grá運動性(ラテン語の文法-「文学の教義」、他のギリシャ語から)γραμματ ική-「文学、文法」)-母国語での筆記と読解のスキルの所有の程度。 伝統的に、「読み書き」という言葉は、読み書きができる、または任意の言語でのみ読むことができる人を意味します。

他のすべてのアプリケーションは「非識字」です-非識字から。

同じシリーズの「おいしい器」など



Кто б сомневался ©   (2015-02-11 17:51) [24]

不器用なものは何ですか? プログラミングの面で、または言語自体のスタイルで? 一般的にどの言語ですか? ロシア語、英語?



Кто б сомневался ©   (2015-02-11 17:54) [25]

よく文書化されたコードの例として、RawTreeView rawsをお勧めします



картман ©   (2015-02-11 18:03) [26]


>不器用とは何ですか? ...
>または言語のスタイルそのもの

私は言語自体で言うでしょう))



Кщд ©   (2015-02-12 07:25) [27]

>ジアー©(11.02.15 17:08)[23]
>他のすべての文芸的使用は文盲によるものです。
指定されたリソースには、辞書へのリンクがあります
念のため:http://www.gramota.ru/slovari/dic/?word=%E3%F0%E0%EC%EE%F2%ED%FB%E9&all=x

他のすべての解釈は通訳の良心による



Jeer ©   (2015-02-12 15:44) [28]

専門用語も同じ文盲です。

読み書き:木材、アスファルト、トイレ、リンゴ、目、睡眠、犬...本、エンジニア、ハンマー、その他に加えてください。

あなたは残りを思いつくでしょう。



Кщд ©   (2015-02-12 16:34) [29]

「木」という言葉の後、私はすべてを理解しました
続行できませんでした



Kilkennycat ©   (2015-02-12 21:40) [30]


>文芸:木、

奇妙な...ピノキオは文盲でした。



MsGuns ©   (2015-02-15 00:44) [31]

高品質で書かれたプログラミングに関する翻訳不可能な(ロシア語の)本に出会ったことはほとんどありません。 明確で簡潔かつ包括的な。 ほとんど唯一の例外として、VostrikovaとKovyazinがもたらした可能性があります。 翻訳者は主に翻訳者に依存しています。 しかし、これはもちろん、特別な文学だけに当てはまるわけではありません:)英語の内容については、私見では、Delphiのネイティブテキストはほとんど理想的です。



MsGuns ©   (2015-02-15 00:49) [32]

「サービス」の結果として、ソフトウェア製品に関する多くのドキュメントと指示を扱わなければなりませんでした。 USERSのために明確かつ簡潔に書くことができない(不本意ですか?) 膨大な数のスクリーンショット、「特定のボタンをクリックしてください」などの愚かなフレーズ、そして一般に読者と実際にはなぜ理解が完全に欠けているのか、これらすべてを行う必要がありますか?
例として、MS SQL Serverのマニュアルを参照できます。IMHOは、マニュアルの記述方法の最もわかりやすい例です。



MsGuns ©   (2015-02-15 00:52) [33]

さて、最後の、簡潔な。 読み書きができ、包括的で、理解しやすく、使いやすいマニュアルを書くことは、まったく簡単ではなく、プログラム自体よりもはるかに難しい場合があります。 そして、他の人にそれを行う方法を教えるのはさらに難しい(ほとんど不可能):)



MsGuns ©   (2015-02-15 01:12) [34]

私は灰色の頭に耳をつける危険があります-「私は犬を食べた」という「秘密」を共有します。
私は書き方をアドバイスしませんが、書き方はアドバイスしません。
だから:
1.いかなる場合でも、プログラムの目的と一般的な機能を十分に詳しく紹介せずに、インターフェース要素の説明からマニュアルを開始しないでください。
2.クリックスルー革命を回避します。 一般に、文脈代名詞も含め、代名詞はすべて無視する必要があります。
3.長くて複雑な文章を書かないでください。 「which」という単語は、1回以上文中で使用しないでください。
4.長いパラグラフは避けてください。
5.読者をばかげたと思わないでください。また、超知的な知識人にとってはさらにそうすべきではありません。 書くことは簡単ですが、適度です。
6.ユーモアを断固として避けます。 読者がジョークの試みを理解していない確率は99,9%。
7.妻やプログラマーではない友人など、見知らぬ人の「裁判所」に最初に提出することなく、マニュアルを「発行」することはお勧めしません。
8.特別な用語を使用しないでください。特別な用語がないとできない場合は、詳細な説明へのリンクを提供するのを怠らないでください。
9.適切な計画なしにガイドを書き始めないでください。
10.マニュアルを最後まで残さないでください。プロジェクトの進行に合わせて書いてください。



MsGuns ©   (2015-02-15 01:21) [35]

かなり有名なソフトウェア製品の多くのマニュアルで非常に人気のある間違いは、「木の後ろの森の消失」の影響です。 何をどのような順番で、そして文章を読んだ後でも、ヒントは消えてしまいますが、なぜ必要なのかを詳しく書いてあります。
それら。 ソフトウェアを使用している間、ユーザーは以前に「紙の上」で非常にうまく行ったいくつかの非常に特定の操作を実行する必要に直面しています。 しかし、彼がプログラムの助けを借りてこれを行う方法はまったく知りません。 そして、マニュアルのテキストの大部分を読んだ後、理解していません。
言い換えれば、リーダーシップは彼のための一種の「チャーター」として機能する必要はありません(ご存知のように、理解する必要はありません-従う必要があります)ではなく、助けとガイドが必要です。
たとえば、新しい文書(契約書、支払い注文、請求書など)を入力する必要があり、メニュー(目次)から適切な文書を愚かに選択し、何を指定し、明確にし、迅速に見つけることができる必要があります。そこで何を押す必要があるか、そしてその理由。



MsGuns ©   (2015-02-15 01:32) [36]

まあ、また個人的な経験から:)
ほとんどのユーザーは、原則として、プログラムの作成者と直接連絡を取る機会がある場合は、マニュアルを読みません。 したがって、XNUMXつの「セット」を書く必要がしばしばありました。XNUMXつは非常に短く、XNUMXつ目は詳細です。 最初は、最も怠惰な嫌がらせから身を守ることです:)
そしてもちろん、組み込みのヒント-ヒント、説明的な署名、フラグメントを助けるためのリンクの最大の使用。 私見、これはどのマニュアルよりもはるかに効果的です。



Германн ©   (2015-02-15 03:01) [37]


> MsGuns©(15.02.15 00:44)[31]
>
>翻訳されていない(ロシア語の)本にほとんど会ったことがない
>高品質で書かれたプログラミング、つまり 簡単にクリア
>そして網羅的。 ほぼ唯一の例外として
> KovyazinのVostrikovaを除いてリードできます。

それら。 「コンポーネント」会議で「宣伝」されている本の場合、「不十分な記述」も考慮されますか?



Inovet ©   (2015-02-15 03:10) [38]

モデレータによって削除されました



Inovet ©   (2015-02-15 03:14) [39]

モデレータによって削除されました



Inovet ©   (2015-02-15 05:30) [40]

> [17]カートマン©(11.02.15 12:13)
>私はここのスタイルが好きでした:http://elementy.ru/lib/431448

ありがとう、読んだ。 優れたノンフィクションの本。



K-1000 ©   (2015-02-15 09:51) [41]

私は彼らが着手した方法が好きでした:

リヒター、カスペルスキー、フレノフ(コードではなく、資料の提示方法)。

次のようなゲームエンジンのさまざまなウィキを読むこともできます。
http://anthill.ant-karlov.ru/wiki/start



Игорь Шевченко ©   (2015-02-15 10:47) [42]

MsGunsに完全に同意します。ロシアの作家が書いたプログラミングに関する優れた本に出会ったことはありません。
エレクトロニクスでもほぼ同じです。
なぜこれらのXNUMXつの領域が正確なのでしょうか。 他の分野で何ができるか、私には言えません:)



K-1000 ©   (2015-02-15 12:04) [43]


>イゴールシェフチェンコ©(15.02.15 10:47)[42]
>
>私はMsGunsに完全に同意します。プログラミングに関する優れた本、
>ロシアの作家によって書かれたものは会ったことがない。


しかし、カスペルスキー、アントン・グリゴリエフなどはどうですか?



ページ: 1 2 全枝

フォーラム:「その他」;
現在のアーカイブ:2015.10.04;
ダウンロード:[xml.tar.bz2];

2階





メモリ:0.74 MB
時間:0.035 c
2-1400096967
得点
2014-05-14 23:49
2015.10.04
stringgridを正しく記入する方法


15-1422180830
AndrewAndrey
2015-01-25 13:13
2015.10.04
アプリケーション0xc0000005の起動エラー


4-1273682403
Zamtmn
2010-05-12 20:40
2015.10.04
WM_CONTEXTMENUがSysTreeView32に届かない


15-1424122299
陪審
2015-02-17 00:31
2015.10.04
お誕生日おめでとうございます! 17 2月2015火曜日


1-1333000560
不明なユーザー
2012-03-29 09:56
2015.10.04
TInterfacedObjectファイティング循環参照





アフリカーンス語 アルバニア語 アラビア語 アルメニア語 アゼルバイジャン語 バスク ベラルーシ ブルガリア語 カタルーニャ語 中国語(簡体字) 中国語(繁体字) クロアチア語 チェコ語 デンマーク語 オランダ語 英語 エストニア語 フィリピン語 フィンランド語 フランス語
ガリシア語 ジョージアン ドイツ語 ギリシャ語 ハイチ語 ヘブライ語 ヒンディー語 ハンガリー語 アイスランド語 インドネシア語 アイリッシュ イタリア語 日本語 韓国語 ラトビア語 リトアニア マケドニア語 マレー語 マルタ語 ノルウェー語
ペルシア語 ポーランド語 ポルトガル語 ルーマニア語 ロシア語 セルビア スロバキア語 スロベニア語 スペイン語 スワヒリ語 スウェーデン語 タイ語 トルコ語 ウクライナ語 ウルドゥー語 ベトナム語 ウェールズ語 イディッシュ語 ベンガル語 ボスニア語
セブアノ語 エスペラント グジャラート語 ハウサ語 モン族 イボ ジャワ語 カンナダ語 クメール語 ラオ語 ラテン マオリ語 マラーティー語 モンゴル語 ネパール語 パンジャブ語 ソマリ タミル語 テルグ語 ヨルバ語
ズールー語
Английский Французский Немецкий Итальянский ポルトガル語 Русский Испанский