Fase attuale:
Risultati annunciati. Consulta la cronologia.
Utilizza questa guida come modello per creare la proposta di progetto della tua organizzazione.
PROPOSAL TITLE - organization name
Il titolo della proposta deve essere breve e specifico. "Aggiorna la guida per i collaboratori di ORGNAME" è un buon titolo per la proposta. "Miglioramenti alla documentazione" è troppo vago; "Aggiorna le sezioni 5, 7, 23, 99 delle guide per i collaboratori, delle domande frequenti e delle guide di stile" è troppo lungo.
Informazioni sulla tua organizzazione
In questa sezione, descrivi la tua organizzazione o il tuo progetto in alcuni brevi paragrafi. Quale problema risolve il tuo progetto? Chi sono i tuoi utenti e collaboratori? Da quanto tempo esiste la tua organizzazione o il tuo progetto? Fornisci un contesto che ci aiuti a capire perché il finanziamento della tua proposta avrebbe un impatto positivo nell'open source e nel mondo.
GloriousPickle (versione corrente 1.2.3, prima release nel 2009) è una libreria autorizzata dal MIT per calcolare facilmente il rapporto perfetto di sale, zucchero, aceto e spezie per ogni possibile verdura sottaceto, in quantità che vanno da un singolo cetriolo solitario a container-navi di ravanelli. I nostri collaboratori sono appassionati di sottaceti di tutto il mondo, mentre i nostri utenti sono chef casalinghi, chef di ristoranti e persone che lavorano nella logistica per grandi aziende e organizzazioni di elaborazione degli alimenti. Il nostro utente più grande è un'organizzazione che aiuta i banche alimentari a trasformare verdure a breve conservazione in barattoli di sottaceti stabili, aiutando a sfamare le persone affamate di molte comunità e riducendo gli sprechi alimentari. Inoltre, i nostri utenti ci inviano metriche facoltative sul loro utilizzo di GloriousPickle, che utilizziamo per produrre PickleSet, un ampio set di dati per la creazione di nuove ricette di sottaceti tramite il machine learning.
Informazioni sul progetto
Il problema del progetto
Descrivi il problema che il tuo progetto contribuirà a risolvere. Perché è importante per la tua organizzazione o per il tuo progetto risolvere questo problema?
Gli utenti vogliono poter aggiungere informazioni su nuove spezie e altri ingredienti (in particolare ingredienti di cucine non europee) allo strumento GloriousPickle. Purtroppo, la procedura per aggiungere queste informazioni non è ben documentata, il che significa che i potenziali collaboratori devono aprire un problema nel progetto per ricevere assistenza (o semplicemente rinunciare del tutto). Il processo presuppone inoltre che i collaboratori abbiano già dimestichezza con la nostra procedura di richiesta di pull e con GitHub, anche se molti dei nostri utenti non sono sviluppatori professionisti.
Più informazioni sugli ingredienti abbiamo, più utile GloriousPickle è per tutti i nostri utenti.
Ambito del progetto
Indica la documentazione che la tua organizzazione creerà, aggiornerà o migliorerà. Se alcuni lavori non vengono eseguiti deliberatamente, includi anche queste informazioni. Includi una stima del tempo e indica se hai già identificato volontari dell'organizzazione e un redattore tecnico per lavorare al tuo progetto.
Il progetto GloriousPickle (nome in codice PicklePlus) eseguirà le seguenti operazioni:
- Controlla la documentazione esistente e crea un log di attrito della documentazione attuale per i tre casi d'uso principali (aggiunta di un nuovo ingrediente, aggiunta di una variante ingrediente e aggiornamento o correzione delle informazioni su un ingrediente).
- Utilizzando il log delle difficoltà come guida per comprendere le lacune nella documentazione, crea una documentazione aggiornata per i casi d'uso principali.
- Creare un breve "cheat sheet" per aiutare i collaboratori alle prime armi con le richieste di pull e GitHub a utilizzare la nostra procedura.
- Raccogli il feedback dei tester della documentazione (volontari nel progetto) e della più ampia community di GloriousPickle.
- Collabora con il team di rilascio per aggiornare la documentazione sul sito GloriousPickle e per creare una procedura per mantenere la documentazione sincronizzata con lo strumento di aggiornamento in futuro.
Attività non incluse nell'ambito di questo progetto:
- Questo progetto non creerà un processo per il collegamento incrociato tra ortografie o nomi diversi per lo stesso ingrediente.
- Questo progetto non creerà tutorial di GitHub, ma il cheat sheet riporterà a materiale esistente pertinente e utile.
Abbiamo due ottimi candidati per la stesura di questo progetto e prevediamo che il lavoro richiederà tre mesi. I GloriousPickle PickleDocs SIG e @GloriousPicklePat (la manutenzione principale dell'API per l'aggiunta degli ingredienti) si sono impegnati a supportare il progetto.
Misurare il successo del progetto
Come fai a sapere che la nuova documentazione ti ha aiutato a risolvere il problema? Quali metriche utilizzerai e come le monitorerai?
GloriousPickle riceve una media di dieci richieste di pull al trimestre per l'aggiunta o l'aggiornamento di nuovi ingredienti (con tag "ingrediente"): la maggior parte di queste richieste di pull (più del 60%) proviene da collaboratori precedenti. Riteniamo che questa migliore documentazione genererà più richieste di pull e più richieste da parte di nuovi collaboratori. Poiché la maggior parte dei nostri collaboratori attivi ha iniziato aggiungendo ingredienti, riteniamo anche che migliorare questa documentazione si tradurrà in un maggior numero di collaboratori attivi.
Monitoreremo due metriche (numero di richieste pull relative agli ingredienti e numero di richieste pull da parte di nuovi collaboratori) mensilmente dopo la pubblicazione della documentazione. Monitoreremo anche il numero di collaboratori che hanno fornito più di tre contributi complessivi, a partire dal trimestre successivo alla pubblicazione della documentazione.
Considereremo il progetto riuscito se, dopo la pubblicazione della nuova documentazione:
- Il numero di richieste pull relative agli ingredienti aumenta del 20%
- Il numero di richieste pull da parte di nuovi collaboratori aumenta del 15%
- Il numero di collaboratori che hanno apportato più di 3 contributi aumenta del 10% (a partire dal trimestre successivo alla pubblicazione della documentazione)
Cronologia
Quanto tempo pensi che ci vorrà per completare il lavoro? Riesci a suddividere le attività di tech writer per mese/settimana?
Il progetto stesso richiederà circa sei mesi. Una volta assunto il Technical Writer, dedicheremo un mese all'orientamento, poi passeremo al controllo e al log dei problemi e gli ultimi mesi alla creazione della documentazione.
| Date | Azioni |
|---|---|
| Maggio | Orientamento |
| Giugno - agosto | Controlla la documentazione esistente e crea un log delle difficoltà |
| Settembre - Ottobre | Creare la documentazione |
| Novembre | Completamento del progetto |
Budget del progetto
Linee guida generali
- Puoi includere il budget nella proposta o come link separato. Se il tuo budget è inferiore a dieci articoli, ti consigliamo di includerlo nella proposta.
- Tutti i budget devono essere in dollari statunitensi. Prevediamo che le donazioni siano comprese tra 5000$e 15.000 $. Se il tuo progetto non rientra in questo intervallo, fornisci informazioni aggiuntive per giustificare il tuo budget.
- Ci aspettiamo che la maggior parte del tuo budget (minimo 60-70%) venga assegnata al Technical Writer al lavoro sul progetto. Ti consigliamo di creare un budget per progetto, se possibile.
- Ci aspettiamo che i progetti open source utilizzino strumenti open source quando possibile; se il tuo progetto richiede assolutamente fondi per licenze software proprietarie o assistenza, includi una giustificazione per l'importo.
- Altre possibili spese includono:
- Progettiamo lavori per creare branding, loghi, modelli o altre risorse di design per il tuo sito di documentazione
- Importi minimi (<$200) per gadget per il progetto (t-shirt o adesivi per i partecipanti). Se utilizzi il logo della stagione di Documenti Google, questo deve essere accompagnato dal logo o dal nome del tuo progetto o della tua organizzazione. I gadget non possono utilizzare il nome Google.
- Stipendi minimi per i volontari che ricoprono ruoli di tutoraggio o consulenza significativi nel progetto (consigliamo di non superare i 500 $per volontario)
- Le donazioni secondarie ad altri progetti open source non devono superare il 10% del budget totale.
- Includi altri elementi del budget, se necessario, insieme alla motivazione dell'importo richiesto. Le giustificazioni delle spese devono evidenziare in che modo la spesa contribuirà al successo del progetto nel suo complesso.
Esempio di budget
| Elemento del budget | Importo | Totale progressivo | Note/giustificazioni |
|---|---|---|---|
| Gli sceneggiatori tecnici controllano, aggiornano, testano e pubblicano nuova documentazione sul processo di aggiunta degli ingredienti per GloriousPickle | 5000,00 | 5000,00 | |
| Stipendi per i volontari | 500 | 6500,00 | 3 borse di volontariato x 500 ciascuna |
| Magliette del progetto (10 magliette) | 150,00 | 6650,00 | |
| Unicorno gonfiabile gigante (versione da 4,5 metri) | 99,99 | 6.749,99 | L'unicorno gonfiabile verrà assegnato al team che risponderà più rapidamente alle domande del redattore tecnico durante il periodo di sviluppo del progetto |
| TOTALE | 6749,99 |
Informazioni aggiuntive
Includi qui eventuali informazioni aggiuntive pertinenti alla tua proposta.
Esperienza precedente con i Technical Writer o con la documentazione: se tu o uno dei tuoi mentori avete già collaborato con gli sceneggiatori tecnici o hai sviluppato della documentazione, indicalo nella tua candidatura. Descrivi la documentazione che hai prodotto e le modalità di collaborazione con il Technical Writer. Ad esempio, descrivi le procedure di revisione che hai utilizzato o come le competenze del redattore tecnico sono state utili per il tuo progetto. Spiega in che modo questa esperienza precedente può aiutarti a lavorare con un Technical Writer durante la stagione dei documenti di Google.
Partecipazione precedente alla Stagione di Google Documenti, all'estate di Google del Codice o ad altri: Se tu o uno dei tuoi mentori avete partecipato a Google Summer of Code o a un programma simile, indicalo nella tua domanda. Descrivi i tuoi risultati in quel programma. Spiega come questa esperienza può influire sul tuo modo di lavorare durante la Stagione dei documenti di Google.