Season of Docs projects

The following are some ideas for potential projects to submit to the Season of Docs program. See also the list of projects for the coding programs like GSoC or CCI.

Implement new syntax for pages

• Summary: (WIP) see #958
• Required skills: Markdown formatting; basic scripting of repetitive tasks; asynchronous coordination of multiple stakeholders in an open, collaborative ecosystem (client authors, PR submitters, project maintainers, etc.)
• Potential mentors: @waldyrious

Completeness: create missing pages

• Summary: tldr pages are not limited to the tools available in popular systems (either installed by default or available in the software repositories); that said, comparing completeness against well-known collections of CLI tools is a good way to ensure coverage of the needs of most users. The main goal of this project is to reach full parity with various popular sets of CLI tools, and is comprised of several sub-goals:
  • Create all missing pages from the GNU Core Utilities (#2213)
  • Create all missing pages from util-linux (#2214)
  • Create all missing pages from the "Who needs a GUI?" article (#1162)
  • Extended goals:
    • Create pages for the individual "page request" issues marked with the help wanted label.
    • Implement an automated check to test and report coverage against lists (#1070)
    • Merge duplicate pages from linux/ and osx/ into common/ (checking not just for availability, but for compatible interfaces as well -- e.g. GNU vs. BSD versions of the same tool).
• Required skills: Interpreting manpages; experimenting with CLI tools (possibly in multiple systems)
• Potential mentors: @sbrl, @pxgamer

Merge the lists of clients on the wiki, the README and the website

• Summary: There are currently three lists of clients, each maintained independently. We want the client lists to live at a single place, so that the lists won't get out of sync nor outdated. The goal is to merge the three lists without losing any relevant information, but keeping it readable. The final list can live at either of the three existing places, or at a new location (e.g. a new CLIENTS.md file). The existing locations should either embed or link to the unified list.
  Links to the existing lists:
  • README: tldr-pages/tldr:README.md#clients
  • Wiki: tldr-pages/tldr/wiki/TLDR-clients
  • Website: https://tldr.sh/#installation
• Required skills: markdown formatting; collaborative development using git and GitHub
• Potential mentors: @waldyrious, @mebeim

Add links to all existing pages

• Summary: Pages now support adding a link to the tool's homepage, but many are still lacking it. The goal of this project is to ensure all pages have a link that people can follow to learn more about the tool and explore more comprehensive documentation. For reference, see the following PRs where multiple links have been added:
  • #2660
  • #2684
• Required skills: Web research; collaborative development using git and GitHub
• Potential mentors: @sbrl