Arduino 项目
使用集合让一切井井有条
根据您的偏好保存内容并对其进行分类。
本页面包含 Google 文档季接受的技术写作项目的详细信息。
项目摘要
- 开源组织:
- Arduino
- 技术文档工程师:
- AghaSaad04
- 项目名称:
- 记录第三方库
- 项目时长:
- 标准时长(3 个月)
Project description
我是一名经验丰富的技术文档工程师。我编写高质量的软件文档、用户指南、手册、算法分析、项目文档和研究论文已超过三年。在本项目中,我将记录所有第三方库。我的目标是记录由 Arduino 创建和贡献的库,以便向开发者展示其所有潜力。我将完成以下任务:
记录库的运作方式
记录如何改进库以满足所需需求
示例
Arduino 的 NESController 库确实需要有完备的资料。您应在其文档中为贡献者提供其功能、兼容性、示例和应用。文档中已经提到了用法,还可以进一步改进。Nbiot-arduino 是一个用于访问 NBIoT 模块的 Arduino 库。可以通过扩展其“ Usage”、“Build &Test”和“Debug Options”来改进其文档。还应添加包含代码段的示例。
Arduino 最加星标的库 ArduinoJson 是有名的记录示例,展示如何在各种站点中使用该库,“API 参考”包含每个类和函数的说明,“常见问题解答”“回答几乎所有问题”以及“为其用户编写程序的 AduinoJson Assistant”。同样,对于需要改进和扩展文档的所有库,都应进行深入的文档编写。
我拥有物联网 (IoT) 领域的丰富经验,并具备有关微控制器的基础知识。我精通各种编程语言,包括 Python、Java、C、C++、HTML5、JavaScript、C#。我非常有兴趣,并愿意利用我的技术写作技能以及电子、微控制器、编程方面的知识为 Arduino 做出贡献。我渴望学习更多知识,提升自己的技能和知识。
由于 Markdown 的语法简单易用且功能丰富,因此我会使用 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 之后,我的未来计划非常明确。我也将继续在其他项目中为组织做出贡献。我会努力从文档和安全等各个方面完善它。只要有时间,我一定会参加组织的任何会议。
条款及条件
本人郑重承诺,将按照上述方式操作,如果发生任何流产,本人将承担相应责任。我理解这个项目需要投入大量的心血,我保证,我将全力以赴完成这个项目,以便提供最好的成果。
感谢您阅读整个提案。如果您还有其他疑问,欢迎随时与我联系。
如未另行说明,那么本页面中的内容已根据知识共享署名 4.0 许可获得了许可。有关详情,请参阅 Google 开发者网站政策。Java 是 Oracle 和/或其关联公司的注册商标。
最后更新时间 (UTC):2025-07-25。
[null,null,["最后更新时间 (UTC):2025-07-25。"],[[["\u003cp\u003eThis Google Season of Docs project focuses on improving the documentation of third-party libraries used within the Arduino ecosystem.\u003c/p\u003e\n"],["\u003cp\u003eThe project aims to create comprehensive documentation, including features, installation instructions, contribution guidelines, and support information for each library.\u003c/p\u003e\n"],["\u003cp\u003eThe technical writer, AghaSaad04, has extensive experience in technical writing and possesses relevant knowledge of programming languages and micro-controllers.\u003c/p\u003e\n"],["\u003cp\u003eA standardized template will be used for documenting the libraries, ensuring consistency and clarity.\u003c/p\u003e\n"],["\u003cp\u003eThe project will involve a significant time commitment, with the writer dedicating 45+ hours per week and maintaining regular communication with their mentor.\u003c/p\u003e\n"]]],["The project aims to improve documentation for Arduino's third-party libraries. The technical writer, AghaSaad04, will document library workings and improvements, focusing on Arduino-made and contributed libraries. Key actions include creating in-depth documentation for each library, including features, installation, contribution guidelines, support, and licensing, using a provided Markdown template. The writer will dedicate 45+ hours weekly, communicating updates via email and Team Viewer with the mentor. The project will be standard length (3 months).\n"],null,["# Arduino project\n\nThis page contains the details of a technical writing project accepted for\nGoogle Season of Docs.\n\nProject summary\n---------------\n\nOpen source organization:\n: Arduino\n\nTechnical writer:\n: AghaSaad04\n\nProject name:\n: Document third-party libraries\n\nProject length:\n: Standard length (3 months)\n\nProject description\n-------------------\n\nI am an experienced technical writer. I have been writing high quality software documentation, user-guides, manuals, algorithm analysis, project documentation, research paper for more than three years.\nIn this project, I will document all the third-party libraries. I aim to document the libraries that are Arduino-made and contributed so that all their potential is exposed towards developers. I will accomplish the following tasks:\n\nDocument the working of the library\nDocument how to Improve the libraries to make them accommodate the required needs\n\n### For Example\n\nArduino's NESController library really needs to be well-documented. Its features, compatibility, examples, applications should be added in its documentation for its contributors. Usage is already mentioned in the documentation which can be improved to a greater extent. Nbiot-arduino is an Arduino Library for accessing NBIoT modules. Its documentation can be improved by extending its Usage, Build \\& Test, Debug Options. Examples containing code snippets should also be included.\nArduino's most starred library ArduinoJson is well-documented as examples showing how to use the library in various stations, API Reference containing the description of each class and function, FAQ that answers to virtually every question and AduinoJson Assistant which writes programs for its users are included in the documentation. Similarly, in-depth documentation should be done for all the libraries whose documentation needs to be improved and extended.\nBeing experienced in the field of Internet of Things (IoT), I have the basic knowledge about micro-controllers. I have proficiency in various programming languages including Python, Java, C, C++, HTML5, JavaScript, C#. I am highly interested and willing to contribute to Arduino through my technical writing skills and the knowledge about electronics, micro-controllers, programming. I am eager to learn more and enhance my skills and knowledge.\n\nI will be using Markdown for styling of all my writing due to its easy-to-use syntax and extensive set of features.\n\n### Template\n\nThis is one of the templates that can be used for the documentation. It can be modified and new sections can be added according to the requirements of the document. \n\n\n $projectName/Library Name\n --------\n In this section, I will give background information of the library, \n what does this library use, on what languages and framework it is based on, \n what are the dependencies of this library/project where it will be used\n\n Features\n --------\n I will add features of the project here like\n - this library creates connection between server and client\n - Make things faster\n\n Installation\n ------------\n In this section I will add the installation procedure and dependencies that \n needs to be installed.\n Install $project by running:\n install project\n\n Contribute\n ----------\n For the contributors, I will add this section in documentation.\n - Issue Tracker: github.com/$project/$project/issues\n - Source Code: github.com/$project/$project\n\n Support\n -------\n This section can also be added\n If you are having issues, please let us know.\n We have a mailing list located at: project@google-groups.com\n\n License\n -------\n This section will tell about the license of the project.\n This project is licensed under the BSD.\n\n### Time commitment and communication\n\nI will give 45+ hours a week but in case of any mishap, I will compensate those\nhours on weekends.During the community bond period, I will discuss communication means and will finalize weekly meetings, means and time for those meetings with my mentor. I will keep my mentor up to date about my work; will share my work details via email to my mentor. I will prefer Team Viewer for communicating, as it is easy to use with lots of features like share screens etc.\n\n### Future Plans\n\nMy future plans are very clear, after GSoD'19. I will keep contributing to the organization in other projects too. I will try to make it perfect in all aspects from documentation perspective to security perspective. I will surely attend any meeting of the organization if I ever get a chance.\n\n### Terms \\& Conditions\n\nI solemnly agree that I will work in the same way that I have explained above and\nin case of any miscarriage, I will be held accountable. I understand the dedication\nrequired for this project, I assure you that I am dedicating my whole season for this project so that I can provide the best work.\n\nThank you for reading the whole proposal. Please reach out to me if there are any further queries."]]