ずいぶん前の2014年に、C＃ビューをTypeScriptコードにオーバークロックする小さなユーティリティを作成しました。 彼女は私に多くの時間と神経を節約しました。 それで、2015年9月に、「実験を膝の上に置く」ことを何らかの消化可能な形式にして、GitHubに注ぐことにしました。 それで、オープンソースソフトウェアの開発への私の素人の参加が始まりました。 時間が経ちました。 そして、昨日、このプロジェクトのリポジトリで、ついに記念日、300回目のコミットが登場しました。 この重要なイベントに関連して、「産業の発展のために」何かを開発することを突然考えた場合、あなたが直面しなければならないことについての私のアマチュアの経験を共有したいと思います。 私はいくつかの図の概要を説明し、いくつかのクールなストーリーを語り、また、オープンソースプロジェクトを作成し、サポートせずにどのようなものかについての印象を共有します。 ママ、パパ、ローン 会社のサポート、支払い、そして...そして自由時間。 猫の下に来て、席に着き、始めましょう。

「良いことをする」

まず、GitHubには9,000万を超えるリポジトリがあります。 それらのいくつかは知られており、いくつかはあまり知られておらず、いくつかは一般にプライベートです。 大衆の人気を考慮して、Githubは課題のために学生、講義のために教師、チュートリアルのために本の著者、そして法律のために愛好家によってさえ使用され始めました。 これがコードとプロジェクトのすごい深aだと想像してみてください！ ただし、ジャーナリストがすぐにあなたに愛着を持ち、有名なリポジトリに名前を付けるように求めたら、すぐに電話をかけるというコニャックのボトルを入れます...まあ、15-30の周りです。 これはどういう意味ですか？ これは、GitHubがソフトウェア製品の巨大な宇宙であり、そのほとんどが著者のみに知られていることを意味します。 そして、おそらく友達に5-10。

この群衆の中で多かれ少なかれ目立つようになることは非常に難しい、と私は言います。

世界中のすべてのユーザーの銀行カードのデータを盗んでGitHubに投稿したとしても、 あなたは禁止され、起訴されます 誰もこれに気付かないでしょう 。 なぜ私はそのような明白なことを言っているのですか？ そして、ここ...彼らは明らかではありません！ 特にこれらの行の著者にとって:)特に3年前。 それから、本当に役に立つことをしたり、タグを示したり、READMEを書いたりして、人々は自分ですべてを見つけ、すべてを自分でダウンロードするだけで十分だと単純に信じました。 まあ、真剣に、47行のコードで本質的に構成されるいくつかの種類の左パッドが1000個の星を獲得したので、私のギズモは開発を客観的に簡素化するものです-そう、300が入力されますよね？

うーん...いいえ。 残念ながら、これは機能しません。 左パッドは2014年に作成され、2016年の有名なイベントまで誰にも明らかに知られていませんでした 。 星の分布図を見ると、非常に不幸な時期にほぼ90度で離陸することがわかります。 この素晴らしいストーリーから明らかにいくつかの悲しい結論があります。

適切なマーケティングがなければ、あなたの世界での最高のアイデアは見過ごされてしまいます。

ブラックPRもPRです。

常にクレイジーな数の星がプロジェクトの成功を示唆しているわけではありません。

しかし、すべてがそれほど悪いわけではありません。 あなたがすでにこれについて落ち込む準備ができているなら、私のアドバイスはあなたのハンカチとすすり泣くための枕を脇に置くことです。

何か便利なことをしてください。 まず第一に-自分に役立つ。

あなたの人生が喜びではないソフトウェア製品なしで推定してください。 ここであなたは個人的にこの投稿を読んでいます。 どのアプリケーション、フレームワーク、サービス 地獄 行方不明ですか 仕事や日常生活で。 あなたはそれを理解しましたか？ 素晴らしい。 グーグルでハンマーし、あなたの要求で発行からそれが憂鬱で吹き飛ばされて不鮮明になったら-先に行ってください！ リポジトリを起動し、IDEを開いて書き込みます。 あなたが夢見たものを書き、収集し、レイアウトします。 答えは簡単です。もしあなたのプロジェクトが特にあなたに利益をもたらすなら、世界中で、おそらくこれを助けてくれてあなたに感謝する人が1000人か2人いるでしょう。 このような聴衆が初めて十分になると確信しています。 次に、小さなこと次第です。彼らの功績をこれらすべての素晴らしい人々に伝え、道に飛び散らないようにすることです。

パンツなしのPR

一部の企業はこの慣行を持っていると聞きました。 インタビューで候補者が彼のオープンソースプロジェクトに言及した場合、次の段落で「星の数」、「ダウンロードの数」、「使用されているライブプロジェクトの数」というトピックについて彼が十字架につけ始めます。 ですから、私はあなたに責任を持って宣言します。あなたはそのような質問者に迅速かつ決定的な言語運動を送り、立ち上がってインタビューを辞め、この会社の名前を永久に忘れて、友人にそれを伝えなければなりません。 マネージャー（またはそこでインタビューする人）がそのような質問を思いついた場合、ほぼ絶対確率で、彼はフリーソフトウェアの開発に問題を抱えたことはなく、マーケティングについて聞いたこともないし、全体として彼が発する音をほとんど重要視しない。 これでの作業は機能しません。

悲しいことですが、明らかに事実です。人気のある大規模なプロジェクトの背後にある私の観察によれば、企業はどういうわけか立っています。

たとえば、直接開発資金の形で：プロジェクトが勤務時間中に行われた場合、事実上支払われます。 はい、はい、「あなたのプロジェクトのための金曜日」があっても-何、あなたはそれが予算内にないと思いますか？ または情報サポートの形式（記事、会議、ビデオ）。 まあ、または「スタッフ」によるサポートの形で、「ヴァシャ、オレグが彼のプロジェクトで機能を作るのを手伝ってください。」 また、このようなプロジェクトに関係する部門全体が存在する場合、EntityFrameworkや.NET Coreなどのオープンソース開発の資金調達の非常に率直なケースは言うまでもありません。 または、一度に（ここで陰謀理論家は「誰がこれから利益を得るか」という質問をするかもしれませんが、我々はそれに着きます）。

会社は私にリソースを提供しました。ただし、生きている人の私の開発の無料テストを除きます。 いいえ、私は文句を言いません-私自身がこれを主張しました。そのため、開発に対するすべての権利と制御は私にあります。 そして、この4年間、請負業者との関係が私をつなげてきた会社にとって、ITはそれほどコアビジネスではありません。 どういうわけか人々をそらすのは不便です。 一般的に、最終結果は次のとおりです。会社は同情的であり、道徳的にサポートし、ライブユーザーでプロジェクトをチェックおよび実行する独自のシステムを提供します。 その代わりに、サポート、バグ修正、協議、実装、スタッフトレーニングの優先権を取得します。 Bozhechki、私は主要なインテグレーターの言葉を言いますが、私のプロジェクトでは約5000行（テストなし）しかありません。

一般的に、ご存じのとおり、私は昇進とPRだけの課題に直面しました。 私が最初に思いついたのは、それをすべて使用する方法を書くことでした。 ここで、私はチートし、有用なものと有用なものを組み合わせることにしました-私はHabrでRTに関する最初の記事を書きました（UFOが招待されました）。 このアイデアは「やった」PRではあまりありませんでしたが、少なくともロシア語のドキュメントのようなものをハブに置くことにしました。 私の同僚は全員ロシア出身なので、少なくとも小さなマニュアルが必要でしたが、通信や音声で全員に説明したくはありませんでした。 そのため、最初の3つの記事が誕生しましたが、それは聴衆に冷ややかに受け入れられました。 これは理解できることです-habrコミュニティの誰かにとって有用である可能性は低いので、私はこれについて心配しません。

ドキュメントについて

私のフレームワークの使用方法に関する知識を人々に提供するのがいいという考えは、最終的に次の形式でそれを定式化するまで私を休ませませんでした。

ここにドキュメントがあるものがあります：プロジェクトコードなしでは役に立たず、プロジェクトコードなしでは役に立たないのです。

素晴らしいアイデアですが、ドキュメントを書くことについては壊滅的に少ししか知りませんでした。 文書化されていないコードに関するメチコフとジョークに加えて、メソッドを記述するために動詞を使用する必要があり、コンストラクターを文書化する必要はないと考えられていました。 これについては、おそらく私の知識は尽きました。 私はREADMEの最初のバージョンを作成し、プロジェクトの説明を記入し、考え始めました。

アマチュアはどのようにドキュメントを書くのですか？ もちろん、doxygenを通じて、プログラマーは他に何を考えることができますか？ すぐに言ってやった。 私の目標は、XMLDOC（Javadocのような、C＃のみ）をギャグすることで、Releaseのアセンブリが「公開されているメンバーのコメントの欠落について」を出さないようにすることでした。

- C# , , "", . , internal



private



C#. : 150 ( — 250), 700 260 . - . , .

20 , - , . , , ? , . . , : — . : MSDN! .

"Gets or sets whether..." — - !

, .

30 , - " ". , , , . , , internal



( package



Java). , ! . , .

, , .

, ! doxygen .

, reference-, doxygen-, 150 , enum-, . — ! XMLDOC- , "" . , .

XMLDOC-, , . Autofac, ReadTheDocs.ord. reStructuredText. , . ? . ? ? , ? ? .

chebureque, . , . , , . , . , … , , ! , , , . . , .

, — . .

: , github wiki markdown- , . , , , , GitHub. . .

. -, , . , - . .

. 9 NuGet, , . , 2016 -. ( ?) !

?

"european it conferences 2016" . C# TypeScript. web, , , , IoT. , . , ! , , , , , " ". " ", " ", " ". , ! ", -, !". .

, , DeveloperDays 2016 . — ? , . , , — , 10 . — , . , , . , . . , , , .

— — — .

— , ! ! —… . , — , . .

. NuGet , 10 . , . , , issues! : . , . , faq, , , , .

StackOverflow! , !

C#- TypeScript, . — ! README , Support policy. StackOverflow , . FAQ. RSS .

, RT StackOverflow — , . ! stargazers Barclays Microsoft. — , , , , , … ! , Insights , JIRA - .

StackOverflow , , . . issues , - . . - . , - . , , ( , — ) , .

TDD — , .

— - , - . ,

, -. ( ), — 10, 99% - .

-, , C# TypeScript . , !

RT, dnx, .NET Standard, 3 .NET Core, 20 TypeScript , .

, - .NET Core :)

, , . , ( !). , , … - ? , : , , , . ( .NET Core, ). ? , .

3 . ? ? ! . , . . zip- — GitHub ! , , , OSS- - .

opensource- ? .

?

OSS : (opensource ) ( ). Microsoft OSS — .NET Core "Microsoft loves Linux" MS-, — Azure . — ! , .

opensource. -, Percona mysql, , " ". , , mysql , . mysql .

, OSS- , , . — : OSS- , . , .

OSS, , — , , , Apache Harmony, Sun Microsystems JRE ( , -).

OSS , . - — , , " " — . . — , , " — , " .. .

OSS — , . — - . , user group, community, , . — , . - . "member of something user group, contributor".

- OSS- , , , . .

, — . , , , . , — .

, , community. — , , , , — , , .

, , , — , , linux. "" Linux. , — . . - , " ", , opensource . . , . , .

. - , - " opensource", — .

, .

opensource, " " opensource- — , .

: OSS- OSS- — . , . .

, , , , " " " opensource". , OSS, . . , , . . , . , — . ? ...

, . :

• 5000 , 225 , 1428 , 380 ;
• 43 ;
• 84 issues ;
• 10 ;
• 107 ;
• 28 ;
• 1100 ;
• ~50 000 - NuGet ( 40 );

GitHub, NuGet.

!