Zulip Open Source Team Chat project
Stay organized with collections
Save and categorize content based on your preferences.
This page contains the details of a technical writing project accepted for
Google Season of Docs.
Project summary
- Open source organization:
- Zulip Open Source Team Chat
- Technical writer:
- drrosa
- Project name:
- Refactoring of ReadTheDocs and API Docs
- Project length:
- Standard length (3 months)
Project description
I will focus on two areas and work on them in parallel. One of them is to improve the quality of zulip.readthedocs.io so that new contributors run into less confusion and doubts along the way. Ideally, the result will be a clear and concise path from a first-time contribution to becoming familiar with how Zulip works. I also plan to work on zulipchat.com/api, api.md, and openapi.md to make the process of documenting additional endpoints easier to understand. Both parts are likely to involve updating/simplifying content, decluttering articles, adding missing developer documentation, and also writing/testing code.
The project will consist of four phases. The first phase will include small familiarization projects, preparatory tooling, and a better understanding of current documentation needs. The purpose of the second phase will be to structure, specify, and prioritize work within the context of Zulip’s goals this fall season. Then I'll move on to the implementation phase of the project. I will be going back and forth with mentors and the rest of Zulip's developer community for feedback. The final phase will be to look back, revise where needed, and write the project report.
I suspect some priorities and tasks are likely to change throughout the work period as a result of what everyone else is working on; including decisions made by the core developers. I expect that learning how to adapt well to such changes will be a necessary aspect of having a successful GSoD experience. It's possible that at some point it will make sense to postpone proposed ideas for later on. Generally speaking, I will be focusing on making sure my work brings value to the overall success of the Zulip open source project.
Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 4.0 License. For details, see the Google Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.
Last updated 2024-11-08 UTC.
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Missing the information I need","missingTheInformationINeed","thumb-down"],["Too complicated / too many steps","tooComplicatedTooManySteps","thumb-down"],["Out of date","outOfDate","thumb-down"],["Samples / code issue","samplesCodeIssue","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2024-11-08 UTC."],[[["This project aims to improve the Zulip developer documentation for easier contribution and understanding."],["The focus is on refining ReadTheDocs for new contributors and enhancing API documentation for easier endpoint documentation."],["The project will involve restructuring, simplifying, and adding content, along with code writing and testing."],["The project is divided into four phases, starting with familiarization and ending with a final report, with continuous feedback and adaptation."],["The project's success is measured by its contribution to the overall success of the Zulip open-source project."]]],["The project focuses on improving Zulip's documentation for contributors and developers. Key actions include enhancing the clarity and conciseness of `zulip.readthedocs.io`, and improving the ease of documenting API endpoints on `zulipchat.com/api`, `api.md`, and `openapi.md`. The work will involve updating content, decluttering articles, adding missing information, and testing code. The project will unfold in four phases: familiarization, structuring/prioritization, implementation, and revision/reporting, with ongoing feedback from the Zulip community. The project will be adaptable to potential changes in priorities.\n"]]