{"full_name":"tldr-pages/tldr","owner":"tldr-pages","name":"tldr","url":"https://github.com/tldr-pages/tldr","description":"Collaborative cheatsheets for console commands 📚.","homepage":"https://tldr.sh","topics":[],"language":"Markdown","license":"NOASSERTION","avatar":"https://avatars.githubusercontent.com/u/7366472?v=4","created_at":"2013-12-08T07:34:43Z","pushed_at":"2026-11-10T09:25:19Z","metrics":{"stars":64183,"forks":5646,"watchers":412,"issues":1841,"prs":23040,"releases":6,"issues_open":null,"issues_closed":null,"prs_open":null,"prs_closed":null,"prs_merged":null,"discussions":65},"growth":{"day":{"stars":12,"forks":0,"base_day":"2026-11-09"}},"history":{"dates":["2026-11-09","2026-11-10"],"stars":[64171,64183],"forks":[5646,5646],"watchers":[412,412],"issues_open":[null,null],"prs_open":[null,null]},"boards":{},"same_owner":[],"issues":[{"number":5653,"title":"Let's document: aws","comments":63,"created_at":"2021-03-31T11:04:18Z"},{"number":1070,"title":"Create lists of commands to test coverage parity against","comments":41,"created_at":"2016-09-17T10:39:20Z"},{"number":3689,"title":"Reach parity with cheat cheatsheets","comments":31,"created_at":"2019-12-24T01:42:11Z"},{"number":5137,"title":"Let's document: tj/git-extras","comments":25,"created_at":"2021-01-11T22:25:13Z"},{"number":3591,"title":"Decide on a free web hosted translation service","comments":24,"created_at":"2019-11-19T18:37:29Z"},{"number":13575,"title":"Page translation request: outdated or missing Portuguese Brazilian pages","comments":22,"created_at":"2024-09-02T19:21:01Z"},{"number":20199,"title":"Translate the translation templates","comments":20,"created_at":"2025-12-22T18:06:12Z"},{"number":3953,"title":"Let's document! Git edition","comments":18,"created_at":"2020-03-30T18:26:40Z"}],"discussions":[{"number":24788,"title":"Is there any senior expert who can update the corresponding manual in Chinese?","comments":3,"category":"Q&A","created_at":"2026-10-19T13:23:51Z"},{"number":23971,"title":"Preferred PR size for a batch of Japanese translations md","comments":1,"category":"Q&A","created_at":"2026-09-13T07:40:37Z"},{"number":22788,"title":"ccline: AI at the zsh prompt when tldr doesn't have what you need","comments":0,"category":"Show and tell","created_at":"2026-06-10T08:56:35Z"},{"number":22055,"title":"In Draw mode, if user holds right mouse, temporary let him use Eraser.","comments":1,"category":"Ideas","created_at":"2026-04-14T15:11:44Z"},{"number":21021,"title":"Showed tldr pages today in Powerful github repos","comments":0,"category":"Show and tell","created_at":"2026-02-06T00:32:09Z"},{"number":21020,"title":"Similar project: Manned Pages","comments":0,"category":"Show and tell","created_at":"2026-02-05T22:48:19Z"},{"number":20929,"title":"Upgrade error, is it because the tldr version is too low?","comments":1,"category":"Q&A","created_at":"2026-01-29T08:26:32Z"},{"number":19918,"title":"General feedback from a tourist / release engineering improvements","comments":1,"category":"Ideas","created_at":"2025-12-10T22:50:49Z"}],"latest_release":{"name":"Client specification v2.3: Option placeholders and old asset website deprecation date","tag":"v2.3","published_at":"2025-03-07T10:33:27Z","body":"Attention maintainers!\r\n\r\nWe have released a new [client specification](https://github.com/tldr-pages/tldr/blob/v2.3/CLIENT-SPECIFICATION.md). In this release we are adding a new client-side syntax to allow the clients to show either shortform or longform options. This should remove a lot of clutter. It would also allow power users to view shortform options by default while showing longform options to new users. The syntax is backwards compatible so there is no need to rush support.\r\n\r\n> [!IMPORTANT]\r\n> The old https://tldr.sh domain will stop providing assets at the end of this year.\r\n\r\n## Changelog\r\n- Added longform/shortform specifications ([#15253](https://github.com/tldr-pages/tldr/pull/15253)) (by @Managor)\r\n- Specify `common` as a supported platform option ([#15855](https://github.com/tldr-pages/tldr/pull/15855)) (by @kbdharun)\r\n- Add the date of removal of the old asset website ([#15862](https://github.com/tldr-pages/tldr/pull/15862)) (by @acuteenvy)\r\n- Various grammar fixes\r\n\r\n## Option placeholders\r\nPreviously we have used a basic placeholder such as `{{-h|--help}}` to show both the short and long options to the user. While this gave the user more information, it also caused a lot of clutter and reduced the pasteability of the commands. The new option placeholder adds single square brackets inside the placeholder (`{{[-h|--help]}}`) where clients are allowed to pick which one to show. It is recommended for the clients to show only longform options by default, but if a client wants to brand itself as a power user tool they can default to showings shortform options. There is also a backwards compatible presentation style for showing both, which is just the curly braces removed (`[-h|--help]`).\r\n\r\n----\r\n\r\n## Style guide improvements\r\nIf you are a contributor to the tldr pages, do check out the [style guide](https://github.com/tldr-pages/tldr/blob/main/contributing-guides/style-guide.md).\r\nWe have made several improvements and restructuring to it such as [standardizing keypress notation](https://github.com/tldr-pages/tldr/blob/main/contributing-guides/style-guide.md#keypress-syntax), adding instructions for [disambiguation](https://github.com/tldr-pages/tldr/blob/main/contributing-guides/style-guide.md#disambiguations) and [grouping](https://github.com/tldr-pages/tldr/blob/main/contributing-guides/style-guide.md#grouping-commands) pages, instructing to avoid using `=` in [option arguments](https://github.com/tldr-pages/tldr/blob/main/contributing-guides/style-guide.md#option-syntax) whenever possible, [example.com clarification](https://github.com/tldr-pages/tldr/blob/main/contributing-guides/style-guide.md#general), and much more."},"readme":true,"readme_zh":false,"news":[],"stale":false,"snapshot_at":"2026-11-10T09:35:25Z","history_start":"2026-09-06"}