Free-programming-books: Cohérence des annonces (aide recherchée)

Créé le 21 oct. 2020  ·  5Commentaires  ·  Source: EbookFoundation/free-programming-books

avec le flot d'ajouts pendant le Hacktoberfest, je vois des sites / éditeurs / plates-formes ajoutés où les liens sont présentés de manière incohérente.
Les livres de goalkicker en sont un exemple.
La plupart de nos listes de goalkickers ressemblent à ceci:
* [Spring Framework Notes for Professionals](https://books.goalkicker.com/SpringFrameworkBook) - Compiled from StackOverflow documentation
Cela donne aux lecteurs une idée de ce à quoi s'attendre et fournit une attribution appropriée. Mais tous nos liens goalkicker ne sont pas formatés de la même manière.

De même, les liens des wikibooks ont été incohérents - il y a déjà un PR travaillant pour résoudre ce problème. # 4230

Notre liste de cours a beaucoup dépensé et l'attribution de la plate-forme a été incohérente. Ça devrait être:
`* titre donné par la ressource - Instructeur / Créateur (plateforme)

Les relations publiques destinées à améliorer la cohérence seront les bienvenues.

PR requested discussion help wanted

Tous les 5 commentaires

@eshellman J'ai également remarqué cette incohérence, est-ce que la mention de la plate-forme comme "YouTube" serait nécessaire ou est-ce implicite si elle n'est pas mentionnée? Semblable à certains liens ayant "HTML" ajouté mais on pourrait supposer que ce serait HTML spécifié autrement (par exemple PDF, EPUB, etc.).

@SethiPandi qu'en pensez-vous?

Vous avez peut-être remarqué la durée de toutes mes réponses, mais j'ai toujours été un fan de verbosité et d'homonymie.

Je pense qu'il est toujours agréable d'être explicite, même pour des choses qu'un utilisateur sensé peut déduire, d'autant plus qu'il n'y a aucune garantie que tous les utilisateurs seront sensés.

À mon avis, la seule chose que l'on peut inférer est le HTML, mais même dans ce cas, je pense qu'il est idéal, bien que cela ne soit pas obligatoire, de le spécifier. Je ne sais pas trop où YouTube peut être considéré comme inférable.

_Ce qui suit ne représente que mon expérience personnelle, pas l'utilisateur moyen._
Je dis cela en tant que personne qui s'attendait personnellement à ce que tous les livres soient des PDF jusqu'à ce que je réalise que la plupart n'étaient en fait pas du tout des PDF. (Je préfère lire hors ligne dans KOReader .)
Bien sûr, je sais cela _ maintenant_, mais pas en tant que personne qui était nouvelle dans le référentiel et qui n'était pas familière avec les conventions.

Nous pouvons éliminer "YouTube" et "Github" des listes. Pour les cours, le nom de la plate-forme est plus utile car les plates-formes offrent des expériences plus variées et peuvent avoir des exigences d'inscription.

«HTML» ne doit être indiqué que lorsqu'il s'agit du seul format disponible - souvent, notre lien mène à une page Web qui propose des liens vers des contenus de plusieurs types.

@eshellman ok super ça sonne bien

Nous devons compiler des notes de cohérence spécifiques au fournisseur. Alors...

Please add the "Compiled from StackOverflow documentation" attribution we use for goalkicker books
For youtube, we prefer "playlist" links and the name of the producer/creators

des PR:
MIT OpenCourseWare # 5087
Wikibooks # 4230
udacity # 3880
leanpub

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

Questions connexes

eshellman picture eshellman  ·  9Commentaires

rosepac picture rosepac  ·  3Commentaires

VicoSilalahi picture VicoSilalahi  ·  4Commentaires

eshellman picture eshellman  ·  18Commentaires

hiverkiya picture hiverkiya  ·  5Commentaires