На этой странице содержится подробная информация о проекте технического написания, принятом для участия в Google Season of Docs.
Краткое описание проекта
- Организация с открытым исходным кодом:
- Ардуино
- Технический писатель:
- АгаСаад04
- Название проекта:
- Документирование сторонних библиотек
- Длина проекта:
- Стандартная продолжительность (3 месяца)
Описание проекта
Я опытный технический писатель. Я пишу высококачественную документацию по программному обеспечению, руководства пользователя, руководства, анализ алгоритмов, проектную документацию, исследовательские работы более трех лет. В этом проекте я буду документировать все сторонние библиотеки. Я стремлюсь документировать библиотеки, созданные и предоставленные Arduino, чтобы весь их потенциал был раскрыт разработчикам. Я решу следующие задачи:
Документируйте работу библиотеки. Документируйте, как улучшить библиотеки, чтобы они соответствовали необходимым потребностям.
Например
Библиотека NESController Arduino действительно должна быть хорошо документирована. Его функции, совместимость, примеры и приложения должны быть добавлены в документацию для его участников. Использование уже упомянуто в документации, которая может быть улучшена в большей степени. Nbiot-arduino — это библиотека Arduino для доступа к модулям NBIoT. Его документацию можно улучшить, расширив параметры использования, сборки и тестирования и отладки. Также следует включить примеры, содержащие фрагменты кода. Самая популярная библиотека Arduino ArduinoJson хорошо документирована, в ней приведены примеры использования библиотеки на различных станциях. Включены справочник API, содержащий описание каждого класса и функции, FAQ, который отвечает практически на все вопросы, и AduinoJson Assistant, который пишет программы для своих пользователей. в документации. Аналогичным образом, углубленная документация должна быть составлена для всех библиотек, чья документация нуждается в улучшении и расширении. Имея опыт работы в области Интернета вещей (IoT), я обладаю базовыми знаниями о микроконтроллерах. Я владею различными языками программирования, включая Python, Java, C, C++, HTML5, JavaScript, C#. Я очень заинтересован и готов внести свой вклад в Arduino посредством своих навыков технического письма и знаний об электронике, микроконтроллерах и программировании. Я стремлюсь учиться больше и совершенствовать свои навыки и знания.
Я буду использовать Markdown для стилизации всех моих текстов из-за его простого в использовании синтаксиса и обширного набора функций.
Шаблон
Это один из шаблонов, которые можно использовать для документации. Его можно изменять и добавлять новые разделы в соответствии с требованиями документа.
$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: project@google-groups.com
License
-------
This section will tell about the license of the project.
This project is licensed under the BSD.
Время и общение
Я буду уделять более 45 часов в неделю, но в случае каких-либо происшествий я компенсирую эти часы по выходным. В течение периода связей с сообществом я буду обсуждать средства общения и завершать еженедельные встречи, средства и время для этих встреч с моим наставником. Я буду держать своего наставника в курсе своей работы; поделюсь подробностями своей работы по электронной почте моему наставнику. Для общения я предпочитаю Team Viewer, поскольку он прост в использовании и имеет множество функций, таких как совместное использование экранов и т. д.
Планы на будущее
Мои планы на будущее после GSoD'19 очень ясны. Я буду продолжать вносить вклад в организацию и в других проектах. Я постараюсь сделать его идеальным во всех аспектах: от документации до безопасности. Я обязательно приду на любое собрание организации, если у меня когда-нибудь появится такая возможность.
Условия использования
Я торжественно соглашаюсь, что буду работать так же, как объяснил выше, и в случае любого выкидыша буду нести ответственность. Я понимаю, какая преданность делу требуется для этого проекта, и уверяю вас, что я посвящаю этому проекту весь свой сезон, чтобы обеспечить лучшую работу.
Спасибо, что прочитали все предложение. Пожалуйста, свяжитесь со мной, если возникнут дополнительные вопросы.