This page covers information for Google Season of Docs 2020. This includes project ideas, interested mentors and tracking of current documentation development.
For applying, see Google Season of Docs technical writer guide.
The link is added within the application and so this site shouldn't be moved to a different URL.
The OpenWrt system is based on several core components, all developed in different code repositories. Each component has documentation that is mainly targeted at OpenWrt developers, but can also be used by “downstream projects” that use, modify and repackage OpenWrt to suit their needs. The documentation of these components is either non-existent, available as a simple README, or maintained on the OpenWrt wiki/website.
The goal of the project is to improve documentation of OpenWrt components by making it more consistent and useful:
It is not required to have a deep technical knowledge of the components. However, in the first part of the project, the applicant will need to get familiar with the overall picture of these components.
Having both code and documentation in the same repository has two big advantages over the current approach:
Device pages, important for users, are often very similar but still vary in steps and formulation, increasing the work of maintaining them. Also the varying structure complicates the user. A template based page generated as used by LineageOS device wiki allows a consistent structure while allowing notes for special cases.
This project idea proposes to unify existing device documentations as much as possible and render them via a template engine. Ideally this reduces the work of maintaining device documentation, adding new devices and lastly make it easier to translate installation guides into multiple languages.
In collaboration with wiki maintainers popular devices should be determinded to form a page prioritization list.
The wiki offers guides on how to use the LuCI, the OpenWrt web interface, for common use cases, which is great because it's the most likely way for basic users to interact with their routers.
However this could get some extra love: Partly pictures are missing, pictures are outdated and/or missing from the web interface overview. This could be refreshed and put in nice overview, maybe even even create click-through videos.
Ideally use/create tools that automatically click things in UIs and make screenshots and thereby reproduce the documentation. This could make the documentation easily future proof and translatable.
OpenWrt has a very wide ecosystem of packages that allow many different use-cases going beyond the simple “home router” scenario.
The idea is to “showcase” several OpenWrt features and their associated use-cases, for instance by writing step-by-step tutorials with screenshots, similar to blog posts. Videos could also be produced alongside the tutorials. This is just a suggestion, other formats can be proposed.
The expected benefits for OpenWrt users are: increased awareness of OpenWrt features, easier access to various setups.
Some examples of features and use-cases to showcase:
OpenWrt can be challenging for new users: is my hardware supported? which version of OpenWrt should I use? can i use snapshots? how do I install OpenWrt? what are all these strange “apm821xx” and “ar71xx” things on the download page? how can I upgrade my router?
The idea of the project is to identify the main hurdles encountered by first-time users, and solve these hurdles to improve the first-time user experience:
The proposed solution could include a “Landing page” for the OpenWrt website with the necessary information and guidance.