Free-programming-books: Coherencia de los listados (se necesita ayuda)
con la avalancha de adiciones durante Hacktoberfest, veo algunos sitios / editores / plataformas agregados donde los enlaces se presentan de manera inconsistente.
Un ejemplo son los libros de goalkicker.
La mayoría de nuestros listados de goleadores se ven así:
* [Spring Framework Notes for Professionals](https://books.goalkicker.com/SpringFrameworkBook) - Compiled from StackOverflow documentation
Esto les da a los lectores una idea de qué esperar y proporciona la atribución adecuada. Pero no todos nuestros enlaces de goalkicker tienen el mismo formato.
Del mismo modo, los enlaces de wikilibros han sido inconsistentes; ya hay un PR trabajando para abordar eso. N.º 4230
Nuestra lista de cursos ha gastado mucho y la atribución de la plataforma ha sido inconsistente. Debería ser:
`* título dado por el recurso - Instructor / Creador (plataforma)
Se darán la bienvenida a los RP para mejorar la consistencia.
eshellman
Todos 5 comentarios
@eshellman También noté esta inconsistencia, ¿sería necesario mencionar la plataforma como "YouTube" o está implícito si no se menciona? Similar a algunos enlaces a los que se les ha agregado "HTML", pero se podría suponer que sería HTML especificado (por ejemplo, PDF, EPUB, etc.).
@SethiPandi ¿qué opinas?
kadhirash
en 24 oct. 2020
Puede que te hayas dado cuenta de lo largas que son todas mis respuestas, pero siempre he sido un fanático de la verbosidad y la desambiguación.
Siento que siempre es bueno ser explícito, incluso para las cosas que un usuario sensato pueda inferir, especialmente porque no hay garantía de que todos los usuarios sean sensatos.
En mi opinión, lo único que puede decirse que se puede inferir es HTML, pero incluso entonces creo que es ideal, aunque no tiene que ser obligatorio, especificarlo. Sin embargo, no estoy seguro de dónde YouTube puede considerarse inferible.
_ Lo siguiente solo representa mi experiencia personal, no el usuario promedio ._
Digo esto como alguien que personalmente esperaba que todos los libros fueran PDF hasta que me di cuenta de que la mayoría, de hecho, no eran PDF en absoluto. (Prefiero leer sin conexión en KOReader ).
Por supuesto, lo sé _ahora_, pero no como una persona que era nueva en el repositorio y no estaba familiarizada con las convenciones.
SethiPandi
en 25 oct. 2020
Podemos eludir "YouTube" y "Github" de los listados. Para los cursos, el nombre de la plataforma es más útil porque las plataformas brindan experiencias más variadas y pueden tener requisitos de registro.
"HTML" debe indicarse solo cuando es el único formato disponible; a menudo, nuestro enlace conduce a una página web que ofrece enlaces a contenido de varios tipos.
eshellman
en 25 oct. 2020
@eshellman está bien, eso suena bien
kadhirash
en 26 oct. 2020
Necesitamos compilar notas de coherencia específicas del proveedor. Asi que...
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
de los RP:
MIT OpenCourseWare # 5087
Wikilibros n.º 4230
udacidad # 3880
leanpub
eshellman
en 6 nov. 2020
Temas relacionados
taiyoslime
·
14Comentarios
hiverkiya
·
5Comentarios
aminought
·
15Comentarios
sayopaul
·
3Comentarios
ghost
·
17Comentarios