Il y a longtemps, en 2014, je me suis fait un petit utilitaire pour overclocker les vues C # en code TypeScript. Elle m'a fait gagner beaucoup de temps et de nerfs. Et donc, en septembre 2015, j'ai décidé de mettre mes "expériences sur le genou" sous une forme digestible et de les verser sur GitHub. C'est ainsi qu'a commencé ma participation amateur au développement de logiciels open source. Le temps a passé. Et donc, hier dans le référentiel avec ce projet, enfin, un anniversaire, le trois centième commit est apparu. Dans le cadre de cet événement important, je voudrais partager mon expérience amateur sur ce que vous devez affronter si vous pensez soudainement à développer quelque chose «au profit du développement de l'industrie». Je vais décrire quelques chiffres, raconter des histoires intéressantes et partager mes impressions sur ce que c'est que d'écrire et de soutenir un projet open source sans mamans, papas et prêts soutien aux entreprises, paiement et ... et temps libre. Venez sous le chat, asseyez-vous, nous commençons.

"Faites ce qui est bon"

Pour commencer, il y a plus de 90 millions de référentiels sur GitHub. Certains d'entre eux sont connus, certains ne sont pas très, certains sont généralement privés. Compte tenu de la popularité de masse, Github a commencé à être utilisé par les étudiants pour les devoirs, les enseignants pour les conférences, les auteurs de livres pour les tutoriels et même les amateurs de législation . Imaginez ce qu'est un putain d'abîme de code et de projets! Cependant, j'ai mis une bouteille de cognac que si un journaliste s'attache à vous en ce moment et vous demande de nommer des référentiels célèbres, alors vous appellerez tout de suite ... eh bien, quelque part vers 15-30. Qu'est-ce que cela signifie? Cela signifie que GitHub est un vaste univers de produits logiciels, dont la plupart, j'en suis sûr, ne sont connus que de leurs auteurs. Et peut-être 5-10 à leurs amis.

Devenir plus ou moins perceptible dans cette foule est assez difficile, je vous le dis.

Même si vous volez les données des cartes bancaires de tous les utilisateurs du monde et les postez sur GitHub, je suis sûr que vous serez banni et poursuivi personne ne le remarquera . Pourquoi dis-je des choses aussi évidentes, demandez-vous? Et là ... bon sang ils ne sont pas évidents! Surtout pour l'auteur de ces lignes :) Surtout il y a 3 ans. Ensuite, j'ai naïvement pensé qu'il suffisait de faire quelque chose de vraiment utile, d'indiquer des balises, d'écrire README et les gens trouveront tout eux-mêmes, téléchargeront tout eux-mêmes. Eh bien, sérieusement, car une sorte de pavé gauche , consistant essentiellement en 47 lignes de code a marqué mille étoiles, alors mon gadget est quelque chose qui simplifie objectivement le développement - eh bien, 300 seront tapés, non?

Mmm ... non. Malheureusement, cela ne fonctionne pas. Le pad gauche a été créé en 2014 et n'était décidément inconnu de personne avant les fameux événements de 2016 . Si vous regardez le graphique de la distribution des étoiles, nous pouvons voir l'augmentation à près de 90 degrés juste à ce moment très malheureux. Il y a évidemment plusieurs tristes conclusions de cette merveilleuse histoire:

Sans marketing approprié, votre meilleure idée au monde passera inaperçue.
Le PR noir est aussi le PR.
Pas toujours un nombre fou de stars suggère que le projet est bon.

Mais tout n'est pas si mal. Si vous êtes déjà prêt à devenir déprimé à ce sujet, alors mon conseil est de mettre de côté vos mouchoirs et votre oreiller en sanglotant.

Mieux vaut faire quelque chose d'utile. Tout d'abord - utile pour vous-même.

Estimez sans quel produit logiciel votre vie n'est pas une joie. Ici, vous lisez personnellement cet article. Quelle application, cadre, service l'enfer vous manquez Au travail ou dans votre vie quotidienne. L'avez-vous compris? Super. Marteau dans google et si de l'émission à votre demande ça souffle avec mélancolie et flou - allez-y! Démarrez un référentiel, ouvrez un IDE et écrivez. Écrivez ce dont vous avez rêvé, rassemblez et disposez. La réponse est simple - si spécifiquement votre projet vous profite, alors dans le monde entier, très probablement, il y aura mille ou deux personnes qui vous aideront également et qui vous seront reconnaissantes. Je suis sûr que pour la première fois, vous aurez plus qu'assez d'un tel public. Ensuite, c'est à la petite chose - de transmettre leurs réalisations à tous ces gens merveilleux et de ne pas barboter le long de la route.

PR sans pantalon

J'ai entendu dire que certaines entreprises ont cette pratique. Si lors de l'entrevue, le candidat mentionne son projet open source, alors le paragraphe suivant, ils commencent à le crucifier sur le sujet "combien d'étoiles?", "Combien de téléchargements?", "Combien de projets live sont utilisés?". Alors, je vous déclare de façon responsable: vous devez envoyer ces interrogateurs avec un mouvement linguistique rapide et décisif, vous lever et quitter l'entretien, en oubliant à jamais le nom de cette entreprise et en le racontant à vos amis. Si le manager (ou celui qui vous y interviewe) pose une telle question, alors avec une probabilité presque absolue, il n'a jamais eu de problème avec le développement de logiciels libres, il n'a jamais entendu parler de marketing, et dans l'ensemble accorde peu d'importance aux sons qu'il émet . Travailler avec cela ne fonctionnera pas.

C'est triste, mais apparemment un fait: selon mes observations, derrière des projets populaires et à grande échelle, les entreprises se tiennent en quelque sorte.

Par exemple, sous forme de financement direct du développement: si le projet est réalisé pendant les heures de travail, il est de facto payé. Oui, oui, même si vous avez un «vendredi pour vos projets» - quoi, pensez-vous que ce n'est pas dans le budget? Ou sous forme de support d'information (articles, conférences, vidéos). Eh bien, ou sous forme de soutien par le «personnel», à la «Vasya, allez aider Oleg à faire un reportage dans son projet». Et cela sans parler des cas très francs de financement du développement open source tels que EntityFramework ou .NET Core, lorsque des départements entiers sont impliqués dans de tels projets. Ou tout d'un coup (ici, les théoriciens du complot peuvent se poser la question «à qui profite-t-il», mais nous y arriverons).

L'entreprise m'a fourni des ressources, à l'exception des tests gratuits de mes développements sur des personnes vivantes. Et non, je ne me plains pas - j'ai moi-même insisté là-dessus, pour que tous les droits et le contrôle sur le développement me restent. Et pour l'entreprise avec laquelle la relation entrepreneur me relie depuis 4 ans, l'informatique n'est pas tellement un cœur de métier. Il n'est pas pratique de distraire les gens d'une manière ou d'une autre. En général, le résultat final était le suivant: la société est sympathique, soutient moralement et fournit son système pour vérifier et exécuter le projet sur les utilisateurs en direct. En échange, il bénéficie d'un droit prioritaire de support et de correction de bugs, ainsi que de consultations, d'implémentation et de formation du personnel. Bozhechki, je dis les mots d'un intégrateur majeur, même si dans mon projet il n'y a qu'environ 5 000 lignes (sans tests).

En général, comme vous le savez, j'ai été confronté à la seule tâche de la promotion et des relations publiques. La première idée qui m'est venue à l'esprit était d'écrire comment tout utiliser. Ici, j'ai décidé de tricher et de combiner utile avec utile - j'ai écrit le premier article sur RT dans un magazine geek (pour lequel UFO était invité). L'idée n'était pas tellement dans le PR "j'ai fait", mais dans la façon de placer au moins une documentation en russe sur le hub. Mes collègues sont tous les mêmes de Russie, donc ils avaient besoin d'au moins un petit manuel, mais ne voulaient pas expliquer la même chose à tout le monde par correspondance ou par la voix. Les trois premiers articles sont donc nés et ont été plutôt froidement accueillis par le public. C'est compréhensible - il est peu probable qu'ils aient été utiles à quelqu'un de la communauté habr, donc je ne m'en inquiète pas.

À propos de la documentation

L'idée qu'il serait bien de donner aux gens des connaissances sur la façon d'utiliser mon framework ne m'a pas reposé jusqu'à ce que je le formule enfin sous cette forme:

Voici le problème avec la documentation: il est inutile sans code de projet, et le code de projet est inutile sans lui.

Merveilleuse idée, mais je savais catastrophiquement peu de choses sur la rédaction de documentation. En plus des mechikov et des blagues sur le code non documenté, la pensée en arrière était qu'il était nécessaire d'utiliser des verbes pour décrire les méthodes, et les constructeurs n'ont pas besoin d'être documentés. Sur ce point, mes connaissances étaient peut-être épuisées. J'ai créé la première version de README , rempli la description du projet et commencé à réfléchir.

Comment un amateur aborde-t-il la rédaction de la documentation? Bien sûr, grâce à doxygen, à quoi d'autre un programmeur peut-il penser? Aussitôt dit, aussitôt fait. Mon objectif était de bâillonner XMLDOC (c'est comme javadoc, uniquement en C #) afin que l'assembly dans Release ne révèle pas "les commentaires manquants pour les membres publiquement visibles".

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

!