TecTop
|
|
Hace unos cinco años anuncié que la documentación de AWS ahora es de código abierto y está en GitHub. Después de un período prolongado de experimentación, archivaremos la mayoría de los repositorios a partir de la semana del 5 de junio y dedicaremos todos nuestros recursos a mejorar directamente la documentación y el sitio web de AWS.
La fuente principal de la mayor parte de la documentación de AWS se encuentra en los sistemas internos que tuvimos que sincronizar manualmente con los repositorios de GitHub. A pesar de los mejores esfuerzos de nuestro equipo de documentación, mantener los repositorios públicos sincronizados con los internos ha demostrado ser muy difícil y requiere mucho tiempo, con varios pasos manuales y algunas ediciones paralelas. Con 262 repositorios separados y miles de lanzamientos de funciones cada año, los gastos generales eran muy altos y en realidad consumían un tiempo precioso que podría haberse utilizado de formas que mejoraran más directamente la calidad de la documentación.
Nuestra intención era aumentar el valor para nuestros clientes a través de la apertura y la colaboración, pero aprendimos a través de los comentarios de los clientes que este no era necesariamente el caso. Después de considerar cuidadosamente muchas opciones, decidimos retirar los repositorios e invertir todos nuestros recursos para mejorar el contenido.
Los repositorios que contienen muestras de código, aplicaciones de muestra, plantillas de CloudFormation, archivos de configuración y otros recursos complementarios permanecerán como están, ya que esos repositorios son fuentes primarias y obtienen un alto nivel de participación.
Para ayudarnos a mejorar la documentación, también estamos enfocando más recursos en sus comentarios:
Observamos las métricas de aprobación y aprobación semanalmente, y usamos las métricas como punteros de nivel superior a las áreas de la documentación que podrían mejorarse. Los comentarios entrantes crean tickets que se envían directamente a la persona o al equipo responsable de la página. Le recomiendo encarecidamente que haga un uso frecuente de ambos mecanismos de retroalimentación.
— jeff;
