Questa pagina contiene i dettagli di un progetto di scrittura tecnica accettato per la stagione dei documenti Google.
Riepilogo del progetto
- Organizzazione open source:
- PostgreSQL
- Technical writer:
- lu
- Nome progetto:
- Tutorial introduttivo
- Durata del progetto:
- Durata standard (3 mesi)
Project description
Aggiorna il tutorial introduttivo per migliorare l'esperienza di installazione e configurazione di PostgreSQL per principianti. (https://www.postgresql.org/docs/current/tutorial-start.html)
Converti il capitolo sui concetti fondamentali dell'architettura in un'introduzione completa ai tutorial PostgreSQL (https://www.postgresql.org/docs/current/tutorial-arch.html). Le possibili opzioni di espansione sono l'architettura client-server, psql come esempio di client da utilizzare in questo tutorial, la terminologia "cluster"" nel contesto PostgreSQL, gli utenti del database rispetto al sistema operativo e la proprietà.
Aggiorna il tutorial sull'installazione (https://www.postgresql.org/docs/current/tutorial-install.html).
- Pubblicizza le opzioni di installazione di origine e binaria. Aggiungi riferimento a https://www.postgresql.org/download/ che offre istruzioni minime per l'installazione binaria.
- Identifica eventuali lacune nelle istruzioni di installazione binarie ed espandi il sito web o risolvile nella documentazione.
- Non fare affidamento sulla lettura e sull'interpretazione del capitolo completo sull'installazione del codice sorgente da parte degli utenti: descrivi i passaggi principali richiesti dopo l'installazione, come l'inizializzazione del cluster e l'avvio (automatico) del server. Fornisci link a capitoli specifici della Documentazione per ulteriori dettagli, ove applicabile.
- Aggiungi i link "See- anche" alle risorse pertinenti che ampliano i valori predefiniti e le best practice per un determinato sistema operativo, se ce ne sono riconosciuti dalla community.
Migliora https://www.postgresql.org/docs/current/tutorial-createdb.html
- Sbarazzati delle istruzioni di "consultare l'amministratore" ove possibile; fornisci soluzioni utili basandoti sul presupposto che l'utente ha seguito il tutorial passo passo.
Migliora https://www.postgresql.org/docs/current/tutorial-accessdb.html
- Spiega i problemi di base relativi all'autenticazione e agli esempi banali di pg_hba.conf
Per fornire questa patch della documentazione, intendo provare il tutorial attuale su Windows e Ubuntu, sfogliare i forum per problemi di configurazione frequenti e consultare i mentori per assicurarmi di adottare le best practice corrette e che i concetti più importanti vengano spiegati senza semplificazioni eccessive.