​​Zulip-GSoD 2019 Project Report
​​

​​Summary

​​The project focused on three aspects of documentation needs. 1) Upgrades to the documentation system’s build tools and troubleshooting warnings and other tooling issues along the way.  2) Improvements to the overall organization/quality of the Production and Subsystems areas of Zulip’s developer documentation. 3) Simplification of articles in zulipchat.com/api so that new users can learn how to access and interact with Zulip’s REST API more easily.
​​

​​Work Done

​​Merged Commits

​​List of commits that Zulip merged into its repository sorted by merged date in descending order:
​​https://github.com/search?o=desc&q=repo%3Azulip%2Fzulip+author%3Adrrosa+author-date%3A2019-07-01..2019-12-10&s=author-date&type=Commits
​​

​​Pull Requests

​​List of PRs that correspond to merged commits and include more details and discussion:
​​https://github.com/zulip/zulip/pulls?utf8=%E2%9C%93&q=is%3Apr+author%3Adrrosa+is%3Aclosed+created%3A2019-07-01..2019-12-10
​​

​​Work Products

​​Reorganized content of articles and subsections

​​https://zulip.readthedocs.io/en/latest/production/export-and-import.html
​​https://zulip.readthedocs.io/en/latest/production/upgrade-or-modify.html
​​https://zulip.readthedocs.io/en/latest/subsystems/html-css.html
​​https://zulip.readthedocs.io/en/latest/development/authentication.html
​​https://zulip.readthedocs.io/en/latest/subsystems/schema-migrations.html
​​https://zulip.readthedocs.io/en/latest/production/maintain-secure-upgrade.html
​​https://zulip.readthedocs.io/en/latest/production/management-commands.html
​​https://zulip.readthedocs.io/en/latest/production/troubleshooting.html#monitoring
​​https://zulip.readthedocs.io/en/latest/production/requirements.html#scalability
​​https://zulip.readthedocs.io/en/latest/documentation/api.html
​​

​​New Articles

​​https://chat.zulip.org/api/client-libraries
​​https://chat.zulip.org/api/api-keys-zuliprc (TBD)
​​

​​Project Status

​​Open Pull Requests pending review

​​https://github.com/zulip/zulip/pulls?utf8=%E2%9C%93&q=is%3Apr+author%3Adrrosa+is%3Aopen+created%3A2019-07-01..2019-12-10
​​

​​Follow-up work

  • ​​Better organize the “Subsystems” section of the developer docs.
  • ​​Proofread and polish newly merged articles in the “Production” section. Discussion here.
​​

​​Challenges and Learnings:

  • ​​At first, I didn’t have a clear procedure on how to merge articles/subsections correctly which led to some confusion and undoing/redoing work, but then after some back and forth it was pretty much smooth sailing.
  • ​​It was quite helpful when my mentor helped refocus priorities about halfway through the project. The guidance Tim provided realigned the documentation efforts with Zulip’s current goals towards an upcoming major release. I felt this improved the overall experience of the project.
  • ​​It was good to learn about reporting issues to upstream projects to help others in the open source community as well as receive help from them if someone figured out a solution.
  • ​​It was nice to receive a prompt and positive response from several developers after @mentioning them in a PR asking if we could list their projects in the documentation.
​​