Free-programming-books: critères pour les livres "en cours"

Créé le 17 mai 2017  ·  9Commentaires  ·  Source: EbookFoundation/free-programming-books

de plus en plus, il y a des suggestions pour ajouter des livres inachevés ou "en cours" à cette liste, par exemple #2252

Quels critères utiliser pour ajouter ce type de livre ?

PR requested discussion

Commentaire le plus utile

que diriez-vous de répertorier les livres en cours comme celui-ci :

À la fin d'une liste de sujets (je pense que le linter mettra les emoji en dernier par ordre alphabétique, sauf pour les caractères obscurs).

Et ajoutez des conseils indiquant que les livres incomplets qui n'ont pas avancé depuis un an doivent être supprimés.

Tous les 9 commentaires

Peut-être l'ajouter avec une étiquette après le lien dans la liste ? Sorte de "brouillon", "en cours", "bloqué", "pas encore terminé", etc.

Les critères utilisés pour les ajouter pourraient être :

  • pourcentage du livre fini (basé sur la table des matières)
  • s'il y a un dépôt public pour la source, pointez dessus, voyez si les commits sont bloqués ou sont en vie (par exemple, le livre dans # 2252 a un dépôt ici https://github.com/munificent/craftinginterpreters/graphs/contributors)
  • contacter les auteurs ?

peut-être 75 % pour l'original, 50 % pour les traductions ?

Peut-être avez-vous une liste spéciale pour les dépôts de livres en cours, pour aider à encourager la participation ?

J'ai demandé à @munificent un commentaire sur Twitter.

Peut-être avez-vous une liste spéciale pour les dépôts de livres en cours, pour aider à encourager la participation ?

Les sous-sections semblent appropriées.

Je suis évidemment partial, mais j'aime l'idée d'énumérer les livres qui sont encore en cours. Je les appellerais d'une certaine manière parce que les gens pourraient être surpris si tout le contenu n'est pas encore là.

Le risque est réel de finir par répertorier des livres incomplets et abandonnés. (J'ai entendu dire par O'Reilly qu'une fraction étonnamment importante de livres techniques meurent avant que l'auteur ne les termine.)

que diriez-vous de répertorier les livres en cours comme celui-ci :

À la fin d'une liste de sujets (je pense que le linter mettra les emoji en dernier par ordre alphabétique, sauf pour les caractères obscurs).

Et ajoutez des conseils indiquant que les livres incomplets qui n'ont pas avancé depuis un an doivent être supprimés.

"Crafting Interpreters" a été fusionné avec un emoji. En raison de la façon dont les linter veulent que les listes soient classées par ordre alphabétique, la liste a été

Les alternatives étaient :

etc.
Avis esthétique bienvenu.

Je préfère cette dernière option, ajouter (🚧 en cours) ou simplement ajouter (🚧) si une légende est ajoutée :
* Books labeled (🚧) are still in the process of being made.

Cela a été un problème ouvert assez longtemps. Partons avec ce format :

J'apprécierais un PR pour CONTRIBUER afin que nous puissions clore le problème.

mis en œuvre.

Cette page vous a été utile?
0 / 5 - 0 notes

Questions connexes

eshellman picture eshellman  ·  18Commentaires

taiyoslime picture taiyoslime  ·  14Commentaires

kakashi215 picture kakashi215  ·  10Commentaires

hiverkiya picture hiverkiya  ·  5Commentaires

eshellman picture eshellman  ·  5Commentaires