Review articles 0023 and 0052 #87
Conversation
EverVino
left a comment
EverVino
left a comment
There was a problem hiding this comment.
Me parece bien las correcciones, sólo hay algunos detalles sobre los link que he dejado como comentario
| [1]: https://opensourcesurvey.org/2017/ "Open Source Survey" | ||
| [2]: http://www.writethedocs.org/guide/writing/beginners-guide-to-docs/#why-write-docs "Write The Docs | Why Write Docs?" |
There was a problem hiding this comment.
Cambiar a
## Referencias
- [Open Source Survey](https://opensourcesurvey.org/2017/)
- [Write The Docs | Why Write Docs](http://www.writethedocs.org/guide/writing/beginners-guide-to-docs/#why-write-docs)
En el formato .md en el cual esta el artículo, cuando se ve el simbolo [] se espera que le siga un link en paréntesis (), creo que al compilarlo sólo omite el texto. |
pages/blog/0023-documentacioncodigoabierto/documentacioncodigoabierto.md
Outdated
Show resolved
Hide resolved
| <!-- TEASER_END --> | ||
|
|
||
| Independientemente del tipo de proyecto en el que participes o de su objetivo, la documentación es un factor muy importante a la hora de crear proyectos accesibles y inclusivos, en el sentido de que facilita muchísimo tanto su uso como la colaboración entre personas que no estén activamente involucradas en su desarrollo. Establecer de forma clara términos de uso del código, manuales o guías permite a tus usuarios ser autosuficientes y dar sugerencias mucho más útiles y profundas, además de que puede ser el factor clave entre que alguien se vuelva un colaborador o que termine ignorando tu proyecto. Tal como dice WriteTheDocs[2]: | ||
| Independientemente del tipo de proyecto en el que participes o de su objetivo, la documentación es un factor muy importante a la hora de crear proyectos accesibles e inclusivos, en el sentido que facilita en gran medida tanto su utilización como la colaboración entre personas que no estén activamente involucradas en su desarrollo. Establecer de forma clara términos de uso del código, manuales o guías permite a tus usuarios ser autosuficientes y dar sugerencias mucho más útiles y profundas, además de que puede ser el factor clave para que alguien se vuelva un colaborador o que termine ignorando tu proyecto. Tal como dice WriteTheDocs [2]: |
There was a problem hiding this comment.
Sugerencia de cambio
En vez de WriteTheDOcs [2] poner
[Write The Docs | Why Write Docs?](http://www.writethedocs.org/guide/writing/beginners-guide-to-docs/#why-write-docs)
Añadiendo tags a sugerencia de Anavelyz
Poniendo un título a referencias
2 participants
Sugerencias de nuevos tags para el artículo 0052: carpentries, ciencia de datos.
Una duda, ¿Cómo se activan los enlaces? ¿Se debe agregar algo en especial?
@EverVino