Notas de la versión: febrero de 2018
El autor de este artículo es Dan Fernandez, director ejecutivo de la división de Cloud + Enterprise.
Febrero ha finalizado y ha llegado la hora de otra entrega de las notas de la versión de docs.microsoft.com.
Nuevas versiones de la documentación
Acabamos de publicar más contenido que le ayudará a aprender y saber más de nuestros productos.
- Ahora hay documentos para desarrolladores de Azure para .NET disponibles para los usuarios en China
- Documentación de referencia de PowerShell de Azure Resource Manager 5.3.0
- Guía del analizador de mensajes de Microsoft
- Documentación de Java sobre Cognitive Services
Seguimos trabajando en la migración de contenido de MSDN a docs.microsoft.com (no solo se garantiza que el contenido se reubica correctamente, sino también que los vínculos apuntan al nuevo contenido en docs.microsoft.com automáticamente). Si detecta vínculos rotos, infórmenos.
Nuevas características y herramientas
Muchas de las características que hemos creado en este último mes estaban en segundo plano: estamos mejorando la estabilidad y la resistencia de nuestros servicios, al tiempo que creamos canalizaciones de publicación para los distintos elementos del contenido. Es decir, se han producido dos importantes incorporaciones, que se muestran a continuación.
Explorador de API para Python
Uno de los puntos clave de la documentación de la API es que sea completa y fácilmente reconocible. Hemos visto que el Explorador de API para .NET y el Explorador de módulos de PowerShell han tenido mucho éxito en la comunidad, por lo que hemos querido facilitarles a los desarrolladores sin experiencia y con experiencia la búsqueda de las API de Python suministradas por Microsoft.
Recientemente, hemos anunciado la publicación del Explorador de API para Python, la mejor forma de encontrar las API de Python que Microsoft envía. Si trabaja con SDK de Azure Python o con Cognitive Toolkit, puede encontrar rápidamente las API relevantes yendo a docs.microsoft.com/python/api.
A medida que aumente el número de las API de Python que enviamos, seguiremos actualizando el Explorador de API para Python con nuevas versiones.
Comentarios del sitio en GitHub
Seguimos promoviendo las iniciativas de franqueza y transparencia en la documentación: nos encanta que nuestra comunidad tenga ocasión de proporcionar comentarios detallados sobre cómo pueden mejorarse las experiencias de documentación. Como parte de esa iniciativa, hemos trasladado nuestro sistema de comentarios para que se base por completo en Problemas de GitHub. El único elemento que quedaba fuera de GitHub eran los comentarios del sitio.
Antes hospedábamos todos nuestros comentarios del sitio docs.microsoft.com en UserVoice y, aunque en aquel momento fue una buena solución, debido a nuestro mayor compromiso con los documentos hospedados en GitHub, queríamos reducir la fricción para los usuarios en cuanto a proporcionar comentarios en el mismo lugar en el que ya se produce la conversación en torno a nuestro contenido, por lo que la decisión siguiente resultó sencilla: mover todos nuestros comentarios del sitio a GitHub.
Realizamos evaluaciones de problemas a diario, por lo que cuando envíe su idea, es probable que sepa de nosotros en breve y las etiquetas le ayudarán a conocer el estado exacto de la solicitud. Más que eso, dada la potencia de la interfaz de usuario de Problemas de GitHub, ahora puede ver el jefe de programas que será responsable del seguimiento:
A medida que hacemos la transición, nos aseguramos de recoger todos los problemas no resueltos de UserVoice y migrarlos a GitHub, así que si ha enviado ideas antes, no se pierden.
Notas al pie
Hay más cosas planeadas para este año y nos complace mostrárselas.
Mientras tanto, asegúrese de seguir nuestro blog y nuestra cuenta de Twitter para ver las actualizaciones más recientes. Si tiene alguna idea o sugerencia sobre las características, no olvide abrir un nuevo problema en GitHub.
¿Sueña con mejorar el mundo de los desarrolladores? Únase a nuestro equipo.