A煤n no tienes acceso a esta clase

Crea una cuenta y contin煤a viendo este curso

El flujo de trabajo moderno

16/18
Recursos

Aportes 39

Preguntas 4

Ordenar por:

驴Quieres ver m谩s aportes, preguntas y respuestas de la comunidad? Crea una cuenta o inicia sesi贸n.

El documentar el c贸digo es algo necesario si queremos ser buenos desarrolladores,

Tu Yo del futuro te lo agradecer谩

Por experiencia les digo que hay veces es dif铆cil entender porque realizamos el c贸digo de una forma, es aun m谩s dif铆cil y casi imposible entender porque otro desarrollador realiz贸 el c贸digo de una forma.
Por esto es muy importante documentar siempre el c贸digo.

隆Hola! Creo que esta clase est谩 mal ubicada en el curso, deber铆an chequear eso.

Pr谩cticamente el core de la documentaci贸n dentro de CodeStream son los CodeMarks porque son como esas sesiones de chat por linea o bloque de c贸digo que va registrando las dudas y respuestas que hubieron y que cualquier nuevo Dev en el equipo puede consultar para que entienda c贸mo funciona eso:D!

Creo que seria buena idea, como los primeros pasos del curso, explicaran u poco mas de como configurar, el codescreen integrado con gitHib, Jira y Slack. Seria un buen tutorial introductorio, en la primera clase, explicar, conexion con github desde vscode, conexion jira code y conexion slack.
Perdon me pierdo un poco con todo el contenido, pero por lo menos linkear, los cursos donde se explica eso detalladamente, si es que existen dentro de la plataforma.
este tema lo veo muy interesante, pero desde el vscode, le dedique demasiado tiempo a intentar arma el entorno como lo tiene Claudio, pero no pude lograrlo.

La documentacion es parte del flujo moderno

-El flujo moderno apunta a la eficiencia
-Muchos lideres de desarrollo responden a las mismas preguntas una y otra vez
-Al usar slack o MS teams se pierde el contexto y el contenido
-Al integrar el code chat se mantiene el contexto y el contenido en el codigo
-El capturar y preservar el conocimiento es parte del activo (asset) de la organizacion

Que debe capturarse

-Todas las actividades relacionadas con la base de codigo de la organizacion:
*comentarios
*mensajes
*issues
*errores de produccion
*sugerencias
*Diagramas
*frecuencia de colaboracion
-todos los metadatos relacionados con el codigo

Donde debe vivir la documentacion

-con el codigo mismo
*utilidad
*conectividad
*accesibilidad
*interactividad
_debe ser exportable a otros formatos
*sistema de documentacion
*sistemas analiticos

Documentacion on demand

  1. En lugar de pensar que documentar, fomentar las preguntas
  2. En lugar de esperar el pull request, fomentar las sugerencias
  3. En lugar de armar documentos de induccion dejar que el nuevo desarrollador explique lo que necesita

Por que docuementar con CodeStream?

  1. Documentacion conectada al codigo
  2. Documentacion interactiva, accesible y exportable
  3. Filtrado de tipos de anotaciones (documentacion, errores, o nota especial) gracias a las etiquetas.
  4. Documentacion en diferentes partes del codigo facil de rastrear.
  5. Compartible y extensible, gracias a los feedback request y otras funcionalidades
  6. Fomenta la documentacion temprana a partir de las preguntas emergentes y casos especiales.
  7. Fomenta las sugerencias antes de un Pull request, cuando se trabaja en equipo.

Resumen de la clase!!

Seria bueno que explicaran mas a fondo la utilizaci贸n de las dem谩s herramientas del curso, por ejemplo yo soy alguien que apenas comienza en el desarrollo , la 煤nica herramienta que conoc铆a era git y github (De el curso de git y github ac谩 en platzi) pero por ejemplo herramientas como Jira no tenia ni idea que exist铆an, seria bueno que a帽adieran a este curso un blog o algo por el estilo donde expliquen para que se utilizan las dem谩s herramientas de manera individual, para que a la hora de realizar la integraci贸n con code stream uno entienda verdaderamente el potencial de esta herramienta

Pues me quedo con el pull request, el issue tracker, comentarios con codemark, y documentacion por lo pronto, esperemos pronto poder agregar a mas gente y darle una repasadita al curso

******El problema de la documentacion

-La mayoria de los equipos de desarrollo no documentan su proyecto
-menos del 20% de los desarrolladores usan la documentacion interna para resolver preguntas
-Al empezar un trabajo nuevo, los desarrolladores pasan el 75% del tiempo estudiando codigo
-Nadie sabe de antemano que pregunta tendra el otro******

16.-El flujo de trabajo moderno

El problema de la documentaci贸n:

  • La mayor铆a de los equipos de desarrollo no documentan sus proyectos.
  • Menos del 20% de los desarrolladores usan la documentaci贸n interna para resolver preguntas.
  • Al empezar un trabajo nuevo, los desarrolladores pasan el 75% del tiempo estudiando el c贸digo.
  • Nadie sabe de antemano que pregunta tendr谩 el otro

La documentaci贸n es parte del flujo moderno:

  • Por que el flujo moderno apunta a la eficiencia.
  • Muchos lideres del desarrollo responden las mismas preguntas una y otra vez.
  • Al usar Slack o MS Teams se pierde el contexto y el contenido.
  • Al integrar Code Chat se mantiene el contexto y el contenido en el c贸digo.
  • El capturar y preservar el conocimiento es parte del activo(asset) de la organizaci贸n.

驴Qu茅 debe capturarse?

  • Todas las actividades relacionadas con la base de c贸digo de la organizaci贸n: comentarios, mensajes, issues, errores en producci贸n, sugerencias, diagramas, frecuencia de colaboraci贸n.
  • Todos los metadatos relacionados con el c贸digo.

驴D贸nde debe vivir esta documentaci贸n?

  • Con el c贸digo mismo: Utilidad, conectividad, accesibilidad, interactividad.
  • Debe ser exportable a otros formatos: Sistema de documentaci贸n, sistemas anal铆ticos.

Documentaci贸n On Demand

  1. En lugar de pensar qu茅 documentar, fomentar las preguntas.
  2. En lugar de esperar al pull request, fomentar las sugerencias.
  3. En lugar de armar documentos de inducci贸n (onboarding), dejar que el nuevo desarrollador explique lo que necesita.

Alguien para hacer un team y practicar lo aprendido hasta ahora con las herramientas codestream, jira, slack y github?

Es una forma brutal como agregar documentaci贸n con codeStream realmente esta herramienta en una mina de oro鈥

Este curso me parecio excelente, si bien, no se usar jira ni slack, y se lo basico de git y github, vi que si se integran estas herramientas ahorraremos tiempo y dolores de cabeza, a seguir aprendiendo con mucha motivacion.

El documentar el c贸digo es algo necesario si queremos ser buenos desarrolladores,

Tu Yo del futuro te lo agradecer谩

Por experiencia les digo que hay veces es dif铆cil entender porque realizamos el c贸digo de una forma, es aun m谩s dif铆cil y casi imposible entender porque otro desarrollador realiz贸 el c贸digo de una forma.
Por esto es muy importante documentar siempre el c贸digo.

Pr谩cticamente el core de la documentaci贸n dentro de CodeStream son los CodeMarks porque son como esas sesiones de chat por linea o bloque de c贸digo que va registrando las dudas y respuestas que hubieron y que cualquier nuevo Dev en el equipo puede consultar para que entienda c贸mo funciona eso:D!

Ya que a muchos no les gusta la documentaci贸n, pero es de suma importancia, CodeStream es la herramienta ideal para automatizar esto.

El problema de la documentacion

La solucion

La verdad al pensar en un proyecto lo que hago siempre es buscar la mejor manera de implementarlo y que no lleve tiempo en su ejecuci贸n.

Me parece que esta clase deber铆a estar ubicada m谩s atr谩s, porque a mi parecer esta clase da inicio a la clase pr谩ctica de la documentaci贸n.

Esto si nos ahorra mucho tiempo y los ingenieros por experiencia somos muy malos para documentar.

隆A implementar CodeStream de inmediato!

Me parece que este curso debe mencionar como prerequisito saber Git, en el orden de la escuela, primero deber铆a estar el curso de Git, y luego este. Muy buen curso, muchas gracias Claudio.

Pregunta de examen:
驴Desde d贸nde empieza la evoluci贸n en la implementaci贸n del flujo moderno?

Codestream hace todo tan sencillo que pude entender el contexto y para que se usan las dem谩s herramientas sin saber nada de slack o jira.

Espero que en las empresas en la que trabaje tengan una metodologia como est谩 en su desarrollo de software

Muy 煤til, 驴se imaginan toparse con un proyecto que est茅 documentado con tags y codemarks? Una belleza.

Excelente aporte y excelentes herramientas, como dicen algunos colegas, puede ser confuso al inicio, pero no solo basta lo que se da en el curso, debemos complementar lo aprendido con consultas externas; el 80% de la vida de los programadores se basa en consultas !

Tu Yo del futuro te lo agradecer谩

Use of CodeStream

Pregunta de examen:
驴Qu茅 es un codemark?

<h2>Y recuerden! Los comentarios bien documentados, son tu mejor amigo!</h2>

Este curso es nuevo casi todas la publicaciones no tienen mas de 14 d铆as ,incre铆ble la herramienta de trabajo que nos presentan ahora a practicarla

Es totalmente un cambio de paradigma.

Es buena pr谩ctica documentar nuestros c贸digo, ya que cada cabeza es un mundo, adem谩s esto evita confusi贸n.

Excelente curso!, lo pondr茅 en pr谩ctica.

Qu茅 debe capturarse.

La documentaci贸n es parte del flujo moderno.