Progetto Arduino

Questa pagina contiene i dettagli di un progetto di scrittura tecnica accettato per la stagione dei documenti Google.

Riepilogo del progetto

Organizzazione open source:

Arduino

Technical writer:

AghaSaad04

Nome progetto:

Librerie di documenti di terze parti

Durata del progetto:

Durata standard (3 mesi)

Project description

Sono un tecnico esperto. Scrivo documentazione software di alta qualità, guide per l'utente, manuali, analisi degli algoritmi, documentazione di progetti, documento di ricerca da più di tre anni. In questo progetto, andrò a documentare tutte le librerie di terze parti. Il mio obiettivo è documentare le librerie realizzate con Arduino e a cui contribuiscono in modo che tutto il loro potenziale sia esposto agli sviluppatori. Effettuerò le seguenti attività:

Documentare il funzionamento della libreria Documentare come migliorare le librerie per soddisfare le esigenze richieste

Ad esempio

La libreria NESController di Arduino deve essere davvero ben documentata. Le funzionalità, la compatibilità, gli esempi e le applicazioni devono essere aggiunti alla documentazione per i collaboratori. L'utilizzo è già menzionato nella documentazione che può essere migliorata in misura maggiore. Nbiot-arduino è una libreria Arduino che consente di accedere ai moduli NBIoT. La documentazione può essere migliorata estendendo le opzioni di utilizzo, build e test e debug. È necessario includere anche esempi contenenti snippet di codice. La libreria ArduinoJson più famosa di Arduino è ben documentata. Gli esempi che mostrano come utilizzare la libreria in varie stazioni, il riferimento API contenente la descrizione di ogni classe e funzione, le domande frequenti che risponde a praticamente ogni domanda e l'assistente AduinoJson che scrive programmi per i suoi utenti sono inclusi nella documentazione. Analogamente, è necessaria una documentazione approfondita per tutte le librerie la cui documentazione deve essere migliorata ed estesa. Avendo esperienza nel campo dell'Internet of Things (IoT), ho le conoscenze di base dei micro-controller. Ho competenze in vari linguaggi di programmazione tra cui Python, Java, C, C++, HTML5, JavaScript e C#. Sono molto interessato e disposta a contribuire ad Arduino attraverso le mie competenze di scrittura tecnica e le mie conoscenze su elettronica, micro-controller e programmazione. Non vedo l'ora di saperne di più e di migliorare le mie competenze e conoscenze.

Utilizzerò Markdown per applicare uno stile a tutti i miei testi grazie alla sua sintassi facile da usare e all'ampio set di funzionalità.

Modello

Questo è uno dei modelli utilizzabili per la documentazione. È possibile modificarlo e aggiungere nuove sezioni in base ai requisiti del documento.

$projectName/Library Name
--------
In this section, I will give background information of the library, 
what does this library use, on what languages and framework it is based on, 
what are the dependencies of this library/project where it will be used

Features
--------
I will add features of the project here like
- this library creates connection between server and client
- Make things faster

Installation
------------
In this section I will add the installation procedure and dependencies that 
needs to be installed.
Install $project by running:
install project

Contribute
----------
For the contributors, I will add this section in documentation.
- Issue Tracker: github.com/$project/$project/issues
- Source Code: github.com/$project/$project

Support
-------
This section can also be added
If you are having issues, please let us know.
We have a mailing list located at: [e-mail]

License
-------
This section will tell about the license of the project.
This project is licensed under the BSD.

Impegno in termini di tempo e comunicazione

Darò più di 45 ore a settimana, ma in caso di disguido, compenserò queste ore nei fine settimana.Durante il periodo del legame con la comunità, parlerò dei mezzi di comunicazione e finalizzerò gli incontri settimanali, i mezzi e il tempo per quegli incontri con il mio mentore. Terrò aggiornato sul mio lavoro il mio mentore e condividerò i dettagli del lavoro via email. Preferisco il Team Viewer per la comunicazione, in quanto è facile da usare e con molte funzioni, come le schermate di condivisione e così via.

Piani futuri

I miei piani per il futuro sono molto chiari, dopo GSoD '19. Continuerò a contribuire all'organizzazione anche in altri progetti. Cercherò di renderlo perfetto sotto ogni aspetto, dal punto di vista della documentazione al punto di vista della sicurezza. Parteciperò sicuramente a qualsiasi riunione dell'organizzazione, se ne avrò la possibilità.

Termini e condizioni

Accetto solennemente di lavorare nello stesso modo indicato in precedenza e di essere ritenuto responsabile in caso di aborti spontanei. Comprendo la dedizione riservata a questo progetto, ti assicuro che dedicherò l'intera stagione a questo progetto, in modo da offrire il miglior lavoro possibile.

Grazie per aver letto l'intera proposta. Non esitare a contattarmi in caso di ulteriori domande.