Guida tecnica per autori

Fase attuale:
Risultati annunciati. Consulta la cronologia.

Questa guida è rivolta ai redattori tecnici interessati a collaborare con le organizzazioni accettate nel programma Google Season of Docs.

Dovresti partecipare al programma Google Season of Docs?

Utilizza queste domande per capire se ti interessa collaborare con un'organizzazione accettata nel programma Google Season of Docs.

  • Hai esperienza e competenze di scrittura tecnica? La stagione dei documenti di Google non ha lo scopo di insegnare le competenze di base di scrittura tecnica. Sei automotivato e organizzato?
  • Hai tempo di partecipare durante i sei mesi del programma? Le dimensioni dei progetti variano, ma vanno da un impegno di 5-30 ore a settimana durante il programma.
  • Ti interessa acquisire esperienza nell'open source? Sei disposto a dedicare del tempo all'apprendimento delle procedure e delle norme della community di un progetto?
  • Sei disposto a collaborare con l'amministratore dell'organizzazione per perfezionare le proposte di progetto, sviluppare tempistiche, valutare e compilare metriche e aiutare l'organizzazione nel suo complesso a comprendere il valore della scrittura tecnica?

Inoltre, devi soddisfare i requisiti di idoneità del programma, tra cui la possibilità di creare un account Open Collective. Tieni presente che devi essere legalmente in grado di ricevere fondi per il lavoro svolto nel tuo luogo di residenza. Gli amministratori del programma Season of Docs non sono in grado di fornire consulenza fiscale o di rispondere a domande sull'idoneità del tuo lavoro.

In qualità di scrittore tecnico esperto che partecipa a Google Season of Docs, riceverai un compenso per acquisire esperienza lavorando in open source e aiutare il tuo progetto a risolvere un'esigenza fondamentale tramite documenti migliori.

Partecipare al programma Google Season of Docs come Technical Writer

Fase di esplorazione

Le domande di partecipazione delle organizzazioni si chiuderanno il 24 marzo 2023 alle ore 18:00 UTC. Consigliamo ai Technical Writer di iniziare a esplorare i possibili progetti il prima possibile. Tuttavia, le organizzazioni possono selezionare i redattori tecnici con cui collaborare in qualsiasi momento prima del 10 maggio 2023 alle 18:00 UTC.

  • Trovare i progetti che ti interessano
    • Contatta direttamente le organizzazioni open source seguendo le istruzioni riportate nella pagina del programma Google Season of Docs o consulta il repository GitHub di Google Season of Docs per trovare le organizzazioni che hanno espresso il proprio interesse a partecipare a Google Season of Docs. Puoi anche trovare organizzazioni interessate nel canale #season-of-docs del gruppo Write the Docs su Slack.
    • Ecco alcuni modi per scegliere un progetto:
      • Scegli un progetto in un linguaggio che conosci o che ti interessa, ad esempio JavaScript o C.
      • Scegli un progetto in una tecnologia o un dominio che ti interessa, ad esempio machine learning, open science o robotica.
      • Scegli un progetto in base alla cordialità della community. Frequenta i loro forum di discussione, dai un'occhiata agli account dei collaboratori sui social media (se parlano del loro progetto lì) e controlla la documentazione di onboarding, se disponibile.
      • Se vuoi collaborare con un progetto che non è nell'elenco, contattalo e chiedigli di prendere in considerazione la possibilità di presentare domanda.
  • Esamina le pagine delle proposte dei progetti
    • Una volta individuati 3-5 possibili progetti, controlla la pagina della proposta di ciascun progetto
    • Dovresti porre domande, fornire feedback e fare suggerimenti utilizzando i canali elencati dal progetto per feedback e discussioni
  • Invia una dichiarazione di interesse direttamente all'organizzazione. Nella dichiarazione di interesse, dovrai dimostrare come raggiungere gli obiettivi indicati nella proposta di progetto dell'organizzazione.
    • Utilizza il modello di dichiarazione di interesse per la Stagione dei documenti di Google. Più breve è, meglio è.
    • Segui le istruzioni riportate nella pagina delle idee dell'organizzazione per inviare la tua dichiarazione di interesse. Se l'organizzazione ha elencato requisiti speciali, assicurati di dimostrare di soddisfarli nella tua dichiarazione.
    • Inviando la tua dichiarazione di interesse, accetti di rispettare il codice di condotta dell'organizzazione e il codice di condotta di Google Season of Docs.

Fase di applicazione

  • Attendi l'annuncio delle organizzazioni accettate da Google per la Season of Docs:
    • Le organizzazioni accettate ti contatteranno direttamente se vogliono collaborare con te o discutere ulteriormente della tua dichiarazione di interesse.
    • Le organizzazioni non sono limitate a collaborare solo con i redattori tecnici che hanno inviato dichiarazioni di interesse entro la scadenza delle domande dell'organizzazione. Potrebbero richiedere ulteriori dichiarazioni di interessi dopo l'accettazione. Le organizzazioni devono selezionare un autore tecnico prima del 10 maggio 2023 alle 18:00 UTC.
    • Le organizzazioni non sono tenute a fornire feedback sulle dichiarazioni di interesse non andate a buon fine.

Fase di sviluppo del progetto

  • Collabora con l'organizzazione per creare un programma, inclusi gli adempimenti e le scadenze.

Fase di valutazione finale e case study

  • Collabora con l'organizzazione per fornire le informazioni necessarie per la valutazione finale e il caso di studio.