Contribuya al contenido técnico de NetApp en GitHub
Sugerir cambios
PDF
La documentación de los productos y servicios de NetApp es de código abierto. Esto le permite contribuir al contenido realizando mejoras, correcciones y sugerencias. Todo lo que necesita es una cuenta de GitHub y una pequeña iniciativa.
Descripción general
Puede contribuir a nuestros documentos utilizando las siguientes opciones:
-
Seleccione Solicitar cambios en el documento para enviar comentarios generales o para hacer una pregunta sobre el contenido. El Director de contenido de NetApp revisa su solicitud para determinar los cambios que se necesitan en los documentos. Esta es la opción más común.
-
Selecciona Editar esta página para editar directamente el contenido tú mismo. A continuación, el Director de contenido de NetApp revisa sus ediciones y las fusiona.
El siguiente vídeo ofrece una breve descripción general de estas dos opciones.
Las siguientes secciones proporcionan instrucciones paso a paso.
Solicitar cambios en el documento
Enviar una solicitud de cambio en la documentación es la forma más común de contribuir a los documentos de NetApp. Una vez que envíe la solicitud, el Director del contenido confirmará que han recibido sus comentarios. Recibirá una notificación por correo electrónico de GitHub cuando lo haga.
Si el responsable del contenido está de acuerdo en que su sugerencia puede mejorar el contenido, se comprometerá el cambio poco después. Recibirá otra notificación para indicarle que se ha incorporado su opinión.
|
Todos los comentarios que proporcione estarán visibles públicamente. Cualquiera que navegue hasta los problemas en GitHub repo puede ver sus comentarios. |
-
Si todavía no tiene una cuenta GitHub, "cree una desde github.com"
-
Inicie sesión en su cuenta de GitHub.
-
Con el explorador Web, abra la página en "docs.netapp.com" eso está relacionado con sus comentarios.
-
En la parte superior de la página, selecciona Sugerir cambios > Solicitar cambios en el documento.
Se abre una nueva pestaña del navegador con un formulario de GitHub que puede utilizar para proporcionar detalles a nuestro equipo de documentos.
-
Introduzca un título, un resumen y confirme que el problema no contiene información confidencial.
El formulario se rellena automáticamente con la URL y el título de la página. No elimine esta información porque la necesitaremos para entender su solicitud.
-
Seleccione Enviar nuevo problema para crear un problema para su solicitud.
Abrir un problema permite la colaboración a través de comentarios de GitHub. Recibirá notificaciones por correo electrónico en función de las preferencias que haya indicado en la configuración de su cuenta de GitHub.
También puede ver el estado de la solicitud seleccionando Issues en el banner de GitHub:
Envíe las ediciones a los documentos
Si se siente cómodo editando el contenido, puede enviar los cambios exactos de documentos que desea ver editando directamente el archivo de origen.
Como colaborador externo, no podrá publicar el cambio directamente. La derivación de contenido revisará los cambios, realizará las modificaciones necesarias y, a continuación, combinará los cambios. Recibirá una notificación por correo electrónico de GitHub cuando esto ocurra.
Si necesita ayuda con nuestro estilo de escritura o sintaxis de origen, puede utilizar estos recursos:
-
Si todavía no tiene una cuenta GitHub, "cree una desde github.com"
-
Inicie sesión en su cuenta de GitHub.
-
Con el explorador Web, abra la página en "docs.netapp.com" que desea editar.
-
En la parte superior de la página, selecciona Sugerir cambios > Editar esta página.
Se abre una nueva pestaña del navegador que le llevará al archivo del repositorio de GitHub para el sitio de documentación.
-
Seleccione el icono de lápiz.
-
Si se te pide que crees una bifurcación del repositorio, selecciona Fork this repository.
-
Edite el contenido.
El contenido está escrito en AsciiDoc, un lenguaje ligero de marcado. "Obtenga más información sobre la sintaxis de AsciiDoc".
-
Para confirmar los cambios, seleccione Confirmar cambios y rellene el formulario:
-
Si lo desea, modifique el mensaje de confirmación por defecto.
-
Agregue una descripción opcional.
-
Selecciona Proponer cambios.
-
-
Selecciona Crear solicitud pull.
Tras proponer los cambios, los revisaremos, realizaremos las modificaciones necesarias y, a continuación, fusionaremos los cambios en el repositorio de GitHub.
Puede ver el estado de la solicitud de extracción seleccionando pull requests en el banner de GitHub:
