Benvenuto! Questo repository contiene tutte le informazioni necessarie per creare la documentazione e il sito web di Kubernetes. Siamo onorati che tu voglia contribuire!
Puoi premere il pulsante Fork in alto nella parte destra dello schermo per creare una copia di questo repository sotto la tua utenza di GitHub. Questa copia è chiamata un fork. Puoi fare tutte le modifiche che vuoi nel tuo fork, e quando sei pronto a mandarci i cambiamenti, vai sulla pagina del tuo fork e crea una nuova pull request per farcelo sapere.
Una volta che hai creato la pull request, un reviewer (revisore) Kubernetes la prenderà in carico per fornire un feedback chiaro e concretamente attuabile. Come owner della pull request, è tua responsabilità modificare la tua pull request per rispondere al feedback che ti è stato fornito dal reviewer Kubernetes. Inoltre, tieni presente che potresti ricevere feedback da più di un Reviewer di Kubernetes, incluse quindi persone diverse da quella che ti ha fornito il primo feedback. In alcuni casi, uno dei tuoi reviewer potrebbe richiedere una revisione tecnica da un technical reviewer di Kubernetes quando necessario. I reviewer faranno del loro meglio per fornire feedback in modo tempestivo, ma i tempi di risposta possono variare in base alle circostanze.
Per maggiori informazioni su come contribuire alla documentazione Kubernetes, vedi:
- Cominciare a contribuire
- Vedere le modifiche localmente
- Utilizzare i template delle pagine
- Guida Stilistica per la documentazione di Kubernetes
- Tradurre la documentazione di Kubernetes
Il modo consigliato per eseguire localmente il sito Web Kubernetes prevede l'utilizzo di un'immagine [Docker] (https://docker.com) inclusa nel sito e configurata con tutti i software necessari, a partire dal generatore di siti web statici [Hugo] (https://gohugo.io).
Se stai utilizzando Windows, avrai bisogno di alcuni strumenti aggiuntivi che puoi installare con [Chocolatey] (https://chocolatey.org).
choco install make
Se preferisci eseguire il sito Web localmente senza Docker, vedi [Eseguire il sito Web localmente utilizzando Hugo](# running-the-site-local-using-hugo) di seguito.
Se hai Docker attivo e funzionante, crea l'immagine Docker kubernetes-hugo localmente:
make docker-imageDopo aver creato l'immagine, è possibile eseguire il sito Web localmente:
make docker-serveApri il tuo browser su http://localhost:1313 per visualizzare il sito Web. Mentre modifichi i file sorgenti, Hugo aggiorna automaticamente il sito Web e forza un aggiornamento della pagina visualizzata nel browser.
Vedi la documentazione ufficiale di Hugo per le istruzioni di installazione di Hugo. Assicurati di installare esattamente la versione di Hugo specificata dalla variabile d'ambiente HUGO_VERSION nel file netlify.toml.
Per eseguire il sito Web localmente dopo aver installato Hugo:
make serveQuesto comando avvierà il server Hugo locale sulla porta 1313. Apri il tuo browser su http://localhost:1313 per visualizzare il sito Web. Mentre apporti modifiche ai file di origine, Hugo aggiorna il sito Web e forza un aggiornamento del browser.
Scopri come interagire con la community di Kubernetes nella pagina della community.
Puoi contattare i maintainers di questo progetto su:
La partecipazione alla comunità Kubernetes è regolata dal Codice di condotta di Kubernetes.
Kubernetes prospera grazie alla partecipazione della comunity e apprezziamo i tuoi contributi al nostro sito Web e alla nostra documentazione!