Contribuisci ai contenuti tecnici di NetApp in GitHub
Suggerisci modifiche
PDF
La documentazione per i prodotti e i servizi NetApp è open source. Ciò consente di contribuire al contenuto apportando miglioramenti, correzioni e suggerimenti. Tutto ciò di cui hai bisogno è un account GitHub e una piccola iniziativa.
Panoramica
Puoi contribuire ai nostri documenti utilizzando le seguenti opzioni:
-
Seleziona Richiedi modifiche alla documentazione per inviare un feedback generale o per porre una domanda sul contenuto. Il responsabile dei contenuti NetApp esamina quindi la tua richiesta per determinare quali modifiche sono necessarie per i documenti. Questa è l'opzione più comune.
-
Seleziona Modifica questa pagina per modificare direttamente il contenuto. Il responsabile dei contenuti NetApp esamina quindi le modifiche e le unisce.
Il video seguente fornisce una breve panoramica di queste due opzioni.
Le sezioni seguenti forniscono istruzioni dettagliate.
Richiedi modifiche al documento
L'invio di una richiesta di modifica del documento è il modo più comune per contribuire ai documenti NetApp. Dopo aver inviato la richiesta, il content lead confermerà di aver ricevuto il tuo feedback. Riceverai una notifica via email da GitHub quando lo farà.
Se il lead del contenuto accetta che il tuo suggerimento può migliorare il contenuto, commetteranno la modifica poco dopo. Riceverai un'altra notifica che ti informa che il tuo feedback è stato incorporato.
|
Tutti i commenti forniti sono pubblicamente visibili. Chiunque si acceda ai problemi nel repo GitHub può vedere i tuoi commenti. |
-
Se non disponi già di un account GitHub, "crearne uno da github.com"
-
Accedi al tuo account GitHub.
-
Utilizzando il browser Web, aprire la pagina su "docs.netapp.com" ciò è correlato al tuo feedback.
-
Nella parte superiore della pagina, selezionare Suggerisci modifiche > Richiedi modifiche doc.
Si apre una nuova scheda del browser con un modulo GitHub che puoi utilizzare per fornire dettagli al nostro team di documentazione.
-
Immettere un titolo, un riepilogo e riconoscere che il problema non contiene informazioni riservate.
Il modulo è precompilato con l'URL e il titolo della pagina. Non eliminare queste informazioni perché saranno necessarie per comprendere la tua richiesta.
-
Selezionare Invia nuovo problema per creare un problema per la richiesta.
L'apertura di un problema consente la collaborazione attraverso i commenti di GitHub. Riceverai notifiche via email in base alle preferenze indicate nelle impostazioni del tuo account GitHub.
È inoltre possibile visualizzare lo stato della richiesta selezionando problemi dal banner GitHub:
Inviare le modifiche ai documenti
Se ti piace modificare i contenuti, puoi inviare le modifiche esatte del documento che desideri vedere modificando direttamente il file di origine.
In qualità di collaboratore esterno, non potrai pubblicare direttamente la modifica. Il responsabile del contenuto esaminerà le modifiche, apporta le modifiche necessarie e le unirà. In questo caso, GitHub riceve una notifica via e-mail.
Se hai bisogno di aiuto con il nostro stile di scrittura o la sintassi di origine, puoi utilizzare queste risorse:
-
Se non disponi già di un account GitHub, "crearne uno da github.com"
-
Accedi al tuo account GitHub.
-
Utilizzando il browser Web, aprire la pagina su "docs.netapp.com" che si desidera modificare.
-
Nella parte superiore della pagina, selezionare Suggerisci modifiche > Modifica questa pagina.
Si apre una nuova scheda del browser che consente di accedere al file nel repository GitHub per il sito della documentazione.
-
Selezionare l'icona a forma di matita.
-
Se ti viene richiesto di creare un fork del repository, seleziona fork this repository.
-
Modificare il contenuto.
Il contenuto è scritto in AsciiDoc, un linguaggio di markup leggero. "Informazioni sulla sintassi di AsciDoc".
-
Per confermare le modifiche, seleziona Conferma modifiche e compila il modulo:
-
Se si desidera, modificare il messaggio di conferma predefinito.
-
Aggiungere una descrizione facoltativa.
-
Selezionare Proponi modifiche.
-
-
Selezionare Crea richiesta pull.
Dopo aver proposto le modifiche, le esamineremo, apporta le modifiche necessarie e le uniremo al repository di GitHub.
È possibile visualizzare lo stato della richiesta pull selezionando richieste pull dal banner GitHub:
