Vor langer Zeit, im Jahr 2014, habe ich ein kleines Dienstprogramm für mich erstellt, um C # -Ansichten in TypeScript-Code zu übertakten. Sie hat mir viel Zeit und Nerven gespart. Und so beschloss ich im September 2015, meine "Experimente am Knie" in eine verdauliche Form zu bringen und sie auf GitHub zu gießen. So begann meine amateurhafte Beteiligung an der Entwicklung von Open-Source-Software. Die Zeit verging. Und so erschien gestern im Repository mit diesem Projekt endlich ein dreihundertstes Jubiläum zum Jubiläum. Im Zusammenhang mit diesem bedeutenden Ereignis möchte ich meine amateurhaften Erfahrungen darüber teilen, was Sie zu tun haben, wenn Sie plötzlich daran denken, etwas „zum Nutzen der Entwicklung der Branche“ zu entwickeln. Ich werde einige Zahlen präsentieren, einige coole Geschichten erzählen und meine Eindrücke davon teilen, wie es ist, ein Open-Source-Projekt ohne zu schreiben und zu unterstützen Mütter, Väter und Kredite Unternehmensunterstützung, Bezahlung und ... und Freizeit. Komm unter die Katze, nimm Platz, wir fangen an.

"Tu was gut ist"

Zunächst gibt es auf GitHub über 90 Millionen Repositories . Einige von ihnen sind bekannt, andere nicht sehr, andere sind im Allgemeinen privat. Angesichts der großen Beliebtheit wurde Github von Schülern für Aufgaben, Lehrern für Vorlesungen, Autoren von Büchern für Tutorials und sogar von Gesetzgebungsbegeisterten verwendet . Stellen Sie sich vor, was für ein verdammter Abgrund an Code und Projekten das ist! Ich habe jedoch eine Flasche Cognac in die Tasche gesteckt. Wenn sich ein Journalist gerade an Sie bindet und Sie auffordert, berühmte Repositories zu benennen, rufen Sie sofort an ... na ja, irgendwo zwischen 15 und 30. Was bedeutet das? Dies bedeutet, dass GitHub ein riesiges Universum von Softwareprodukten ist, von denen die meisten sicher nur ihren Autoren bekannt sind. Und vielleicht 5-10 an ihre Freunde.

Es ist ziemlich schwierig, in dieser Menge mehr oder weniger aufzufallen, sage ich Ihnen.

Selbst wenn Sie die Daten von Bankkarten aller Benutzer der Welt stehlen und auf GitHub veröffentlichen, bin ich mir sicher, dass Sie werden verboten und strafrechtlich verfolgt niemand wird es bemerken . Warum sage ich so offensichtliche Dinge, fragst du? Und hier ... verdammt, sie sind nicht offensichtlich! Speziell für den Autor dieser Zeilen :) Besonders vor 3 Jahren. Dann dachte ich naiv, dass es ausreicht, etwas wirklich Nützliches zu tun, Tags anzuzeigen, README zu schreiben, und die Leute werden alles selbst finden, alles selbst herunterladen. Nun, im Ernst, da eine Art linkes Pad , das im Wesentlichen aus 47 Codezeilen besteht, tausend Sterne erzielt hat, ist mein Gizmo etwas, das die Entwicklung objektiv vereinfacht - nun, 300 werden getippt, oder?

Mmm ... nein. Dies funktioniert leider nicht. Das linke Pad wurde 2014 erstellt und war bis zu den berühmten Ereignissen des Jahres 2016 niemandem bekannt . Wenn Sie sich die grafische Darstellung der Verteilung der Sterne ansehen, können wir den Anstieg bei fast 90 Grad gerade zu dieser sehr unglücklichen Zeit sehen. Es gibt offensichtlich mehrere traurige Schlussfolgerungen aus dieser wunderbaren Geschichte:

Ohne richtiges Marketing bleibt Ihre beste Idee der Welt unbemerkt.
Schwarze PR ist auch PR.
Nicht immer eine verrückte Anzahl von Sternen deutet darauf hin, dass das Projekt gut ist.

Aber nicht alles ist so schlecht. Wenn Sie bereits bereit sind, darüber depressiv zu werden, ist mein Rat, Ihre Taschentücher und das schluchzende Kissen beiseite zu legen.

Mach lieber etwas Nützliches. Zuallererst - nützlich für sich.

Schätzen Sie, ohne welches Softwareprodukt Ihr Leben keine Freude ist. Hier lesen Sie persönlich diesen Beitrag. Welche Anwendung, Framework, Service Hölle vermisst du Bei Ihrer Arbeit oder in Ihrem täglichen Leben. Hast du es herausgefunden? Großartig. Hammer in Google und wenn von der Ausgabe auf Ihre Anfrage es mit Melancholie und verschwommen bläst - fahren Sie fort! Starten Sie ein Repository, öffnen Sie eine IDE und schreiben Sie. Schreiben Sie, wovon Sie geträumt haben, sammeln Sie und legen Sie aus. Die Antwort ist einfach: Wenn Ihr Projekt speziell für Sie von Nutzen ist, gibt es auf der ganzen Welt höchstwahrscheinlich tausend oder zwei Personen, die ebenfalls helfen und Ihnen dankbar sind. Ich bin sicher, dass Sie zum ersten Mal mehr als genug von einem solchen Publikum haben werden. Dann ist es an der kleinen Sache - all diesen wunderbaren Menschen ihre Errungenschaften zu vermitteln und nicht auf der Straße zu planschen.

PR ohne Hose

Ich habe gehört, dass einige Unternehmen diese Praxis haben. Wenn der Kandidat im Interview sein OpenSource-Projekt erwähnt, beginnt er im nächsten Absatz, ihn zum Thema „Wie viele Sterne?“, „Wie viele Downloads?“, „Wie viele Live-Projekte werden verwendet?“ Zu kreuzigen. Also erkläre ich Ihnen gegenüber verantwortlich: Sie müssen solche Fragesteller mit einer schnellen und entschlossenen Bewegung Ihrer Zunge schicken, aufstehen und das Interview verlassen, den Namen dieser Firma für immer vergessen und Ihren Freunden davon erzählen. Wenn der Manager (oder wer auch immer Sie dort interviewt) eine solche Frage stellt, dann hatte er mit nahezu absoluter Wahrscheinlichkeit nie ein Problem mit der Entwicklung freier Software, er hat noch nie von Marketing gehört und legt insgesamt wenig Wert auf die Geräusche, die er macht . Arbeiten damit funktioniert nicht.

Es ist traurig, aber anscheinend eine Tatsache: Nach meinen Beobachtungen stehen Unternehmen hinter populären und großen Projekten irgendwie.

Zum Beispiel in Form einer direkten Entwicklungsfinanzierung: Wenn das Projekt während der Arbeitszeit durchgeführt wird, wird es de facto bezahlt. Ja, ja, auch wenn Sie einen "Freitag für Ihre Projekte" haben - was, denken Sie, ist er nicht im Budget enthalten? Oder in Form von Informationsunterstützung (Artikel, Konferenzen, Videos). Nun, oder in Form der Unterstützung durch "Mitarbeiter", a la "Vasya, helfen Sie Oleg, ein Feature in seinem Projekt zu machen." Ganz zu schweigen von den sehr offenen Fällen der Finanzierung von Open Source-Entwicklungen wie EntityFramework oder .NET Core, wenn ganze Abteilungen an solchen Projekten beteiligt sind. Oder auf einmal (hier mögen die Verschwörungstheoretiker die Frage stellen, "wer davon profitiert", aber wir werden darauf zurückkommen).

Das Unternehmen stellte mir Ressourcen zur Verfügung, mit Ausnahme der kostenlosen Prüfung meiner Entwicklungen an lebenden Menschen. Und nein, ich beschwere mich nicht - ich selbst habe darauf bestanden, damit alle Rechte und die Kontrolle über die Entwicklung bei mir bleiben. Und für das Unternehmen, mit dem mich die Vertragsbeziehung seit 4 Jahren verbindet, ist die IT weniger ein Kerngeschäft. Es ist unpraktisch, Leute irgendwie abzulenken. Im Allgemeinen lautete das Fazit wie folgt: Das Unternehmen geht verständnisvoll vor, unterstützt moralisch und stellt sein System zur Überprüfung und Ausführung des Projekts für Live-Benutzer bereit. Im Gegenzug erhält es ein vorrangiges Recht auf Support und Fehlerbehebung sowie auf Konsultationen, Implementierung und Schulung des Personals. Bozhechki, ich sage die Worte eines großen Integrators, obwohl es in meinem Projekt nur ungefähr fünftausend Zeilen gibt (ohne Tests).

Wie Sie wissen, stand ich im Allgemeinen allein vor der Aufgabe der Werbung und PR. Die erste Idee, die mir in den Sinn kam, war zu schreiben, wie man alles benutzt. Hier habe ich beschlossen, nützlich mit nützlich zu betrügen und zu kombinieren - ich habe den ersten Artikel über RT in einem Geek-Magazin geschrieben (zu dem UFO eingeladen wurde). Die Idee war nicht so sehr in der PR "Ich habe", sondern darin, wie man zumindest eine russischsprachige Dokumentation auf dem Hub platziert. Meine Kollegen sind alle gleich aus Russland, deshalb brauchten sie mindestens ein kleines Handbuch, wollten es aber nicht jedem in der Korrespondenz oder per Stimme erklären. So entstanden die ersten drei Artikel, die vom Publikum eher kalt aufgenommen wurden. Das ist verständlich - es ist unwahrscheinlich, dass sie jemandem aus der Habr-Community nützlich waren, also mache ich mir darüber keine Sorgen.

Informationen zur Dokumentation

Die Idee, dass es schön wäre, den Leuten Wissen über die Verwendung meines Frameworks zu vermitteln, gab mir keine Ruhe, bis ich es schließlich in dieser Form formulierte:

Hier ist die Sache mit der Dokumentation: Sie ist ohne Projektcode nutzlos, und Projektcode ist ohne sie nutzlos.

Wunderbare Idee, aber ich wusste katastrophal wenig über das Schreiben von Dokumentation. Neben Mechikov und Witzen über undokumentierten Code war der Grundgedanke, dass es notwendig war, Verben zur Beschreibung von Methoden zu verwenden, und Konstruktoren müssen nicht dokumentiert werden. In dieser Hinsicht war mein Wissen vielleicht erschöpft. Ich erstellte die erste Version von README , füllte die Projektbeschreibung aus und begann nachzudenken.

Wie geht ein Amateur mit dem Schreiben von Dokumentation um? Was kann sich ein Programmierer durch Sauerstoff nur noch vorstellen? Kaum gesagt als getan. Mein Ziel war es, XMLDOC zu würgen (es ist wie Javadoc, nur in C #), damit die Assembly in Release nicht "über fehlende Kommentare für öffentlich sichtbare Mitglieder" informiert.

- 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.

!