Eventos
31 mar, 23 - 2 abr, 23
Evento de aprendizaje de SQL, Fabric y Power BI más grande. 31 de marzo – 2 de abril. Use el código FABINSIDER para ahorrar $400.
Regístrate hoyEste explorador ya no se admite.
Actualice a Microsoft Edge para aprovechar las características y actualizaciones de seguridad más recientes, y disponer de soporte técnico.
Se aplica a: SQL Server
Azure SQL Database
Azure Synapse Analytics
Analytics Platform System (PDW)
Cualquier usuario puede colaborar en la documentación de SQL Server. Implica la corrección de errores tipográficos, la sugerencia de explicaciones mejoradas y la mejora de la precisión técnica. En este artículo se explica cómo empezar con las colaboraciones de contenido y cómo funciona el proceso.
Hay dos flujos de trabajo principales que se pueden aplicar para colaborar:
Flujo de trabajo | Descripción |
---|---|
Edición en el navegador | Es útil para ediciones rápidas y breves de cualquier artículo. |
Edición local con herramientas | Es útil para ediciones más complejas, ediciones que afecten a varios artículos y colaboraciones frecuentes. |
El equipo de contenido de SQL valida todas las colaboraciones públicas para mejorar la precisión técnica y la coherencia.
Puede realizar modificaciones sencillas en el contenido de SQL Server en el explorador y, después, enviarlas a Microsoft. Para obtener más información, consulte la Información general de la guía para colaboradores.
El proceso se resume en los pasos siguientes:
En el GIF siguiente se muestra el proceso completo para enviar los cambios en el explorador:
Otra opción de edición consiste en bifurcar los repositorios sql-docs
o azure-docs
y clonarlos localmente en el equipo. Después puede usar un editor de Markdown y un cliente de Git para enviar los cambios. Este flujo de trabajo es útil para las ediciones que son más complejas o que afectan a varios archivos. También es útil para colaboradores frecuentes en la documentación técnica de Microsoft.
Para colaborar con este método, consulte los siguientes artículos:
Si envía una solicitud de incorporación de cambios con cambios importantes en la documentación, recibe un comentario en GitHub en el que se le pide que envíe un contrato de licencia de colaboración (CLA) en línea. Debe cumplimentar el formulario en línea para que se pueda aceptar la solicitud de incorporación de cambios.
Si se aceptan los cambios, será reconocido como colaborador en la parte superior del artículo.
En esta sección se muestran más adicionales sobre cómo trabajar en el repositorio sql-docs
.
Importante
La información de esta sección es específica de sql-docs
. Si edita un artículo de SQL en la documentación de Azure, consulte el archivo Léame del repositorio azure-docs en GitHub.
El repositorio sql-docs usa muchas carpetas estándares para organizar el contenido.
Carpeta | Descripción |
---|---|
docs | Contiene todo el contenido publicado de SQL Server. Las subcarpetas organizan de forma lógica distintas áreas del contenido. |
docs/includes | Contiene archivos de inclusión. Estos archivos son bloques de contenido que se pueden incluir en uno o más artículos. |
./media |
Cada carpeta puede tener una subcarpeta media para imágenes de artículos. La carpeta media tiene a su vez subcarpetas con el mismo nombre que los artículos en los que aparece la imagen. Las imágenes deben ser archivos .png con todas las letras en minúsculas y sin espacios en blanco. |
TOC.MD |
Archivo de tabla de contenidos. Cada subcarpeta tiene la opción de usar un archivo TOC.MD. |
Todos los artículos de SQL Server contienen un archivo de inclusión applies-to
después del título. Indica las áreas o las versiones de SQL Server a las que se aplica el artículo.
Observe el siguiente ejemplo de Markdown, que incorpora el archivo de inclusión applies-to-version/sql-asdb-asa-pdw.md
.
[!INCLUDE [SQL Server Azure SQL Database Synapse Analytics PDW](../includes/applies-to-version/sql-asdb-asdbmi-asa-pdw.md)]
De esta manera se agrega el siguiente texto en la parte superior del artículo:
Para buscar el archivo de inclusión applies-to correcto para su artículo, aplique las siguientes sugerencias:
applies-to
. Puede usar el botón Find (Buscar) en GitHub para filtrar rápidamente. Seleccione el archivo para ver cómo se representa.x
en la cadena, suelen ser marcadores de posición que indican la falta de compatibilidad de un servicio. Por ejemplo, appliesto-xx-xxxx-asdw-xxx-md.md
indica compatibilidad solo con Azure Synapse Analytics, porque solo se especifica asdw
y los demás campos contienen x
.tsql-appliesto-ss2017-xxxx-xxxx-xxx-md.md
. Use estos archivos de inclusión únicamente si sabe que la característica se ha introducido con una versión específica de SQL Server.Sugerencia
Si tiene comentarios sobre el producto en vez de comentarios sobre la documentación, aquí puede enviar comentarios sobre el producto de SQL Server.
Explore el repositorio sql-docs en GitHub.
Busque un artículo, envíe un cambio y ayude a la comunidad de SQL Server.
Gracias.
Eventos
31 mar, 23 - 2 abr, 23
Evento de aprendizaje de SQL, Fabric y Power BI más grande. 31 de marzo – 2 de abril. Use el código FABINSIDER para ahorrar $400.
Regístrate hoyCursos
Módulo
Contribuir a la documentación de Microsoft Learn en el explorador - Training
Conviértase en colaborador de la documentación de Microsoft Learn realizando modificaciones con un editor web en GitHub. Realice los cambios y, a continuación, cree, valide y envíe solicitudes de cambios para publicar los cambios.
Certificación
Microsoft Certified: Azure Database Administrator Associate - Certifications
Administre una infraestructura de base de datos de SQL Server para bases de datos relacionales locales e híbridas en la nube mediante las ofertas de bases de datos relacionales PaaS de Microsoft.