Calling all maintainers of both clients and tldr alike! Since the previous [v2.1](https://github.com/tldr-pages/tldr/releases/tag/v2.1) release, a lot of work has been going on behind the scenes to improve `tldr` and how we publish and distribute assets. > [!IMPORTANT] > With this release, we are introducing a newer version of client specification with a major change to the asset URLs to use GitHub releases (to replace the existing method of providing assets via the <https://tldr.sh> domain). ## Changelog 📜 - Removed redirect text from the [caching section](#caching) ([#12133](https://github.com/tldr-pages/tldr/pull/12133)) (thanks @sbrl) - Updated asset URLs to use GitHub releases ([#12158](https://github.com/tldr-pages/tldr/pull/12158)) (thanks @acuteenvy) - Add requirement to disambiguate triple-brace placeholders ([#12158](https://github.com/tldr-pages/tldr/pull/12158)) (thanks @acuteenvy) - Add notice to deprecate the old asset URL ([#12452](https://github.com/tldr-pages/tldr/pull/12452)) (thanks @acuteenvy) ## Change in Asset URLs Previously, we distributed assets via GitHub pages hosted in a combined Git repository for both the website and the assets artifacts. Which introduced multiple issues with maintenance and size constraints, after multiple discussions like [#12048](https://github.com/tldr-pages/tldr/issues/12048), we concluded that GitHub releases are the ideal candidate to publish the ZIP, PDF and checksum assets in a rewriteable way. This client specification release requires all clients to update their cache URLs to the new GitHub release URLs. The updated caching section is attached below for reference: > If appropriate, it is RECOMMENDED that clients implement a cache of pages. If implemented, clients MUST download the entire archive either as a whole from **<https://github.com/tldr-pages/tldr/releases/latest/download/tldr.zip>** or download language-specific archives in the format `https://github.com/tldr-pages/tldr/releases/latest/download/tldr-pages.{{language-code}}.zip` (e.g. **<https://github.com/tldr-pages/tldr/releases/latest/download/tldr-pages.en.zip>**). The English archive is also available from **<https://github.com/tldr-pages/tldr/releases/latest/download/tldr-pages.zip>**. > [!CAUTION] > Prior to version 2.2, the client specification stated that clients MUST download archives from <https://tldr.sh/assets>. This method is now deprecated, and **_will be removed_** in the future. > Caching SHOULD be done according to the user's language configuration (if any), to not waste unneeded space for unused languages. Additionally, clients MAY automatically update the cache regularly. ---- ## 10 years of TLDR pages 🎉 We're thrilled to announce that the TLDR pages project celebrated its tenth anniversary this past December, marking a decade since @rprieto's [initial commit](https://github.com/tldr-pages/tldr/commit/11264d9b19000734a2d35ecbdbdebc0b0b45aed9). What began with a focus on `osx` has blossomed over the years into a comprehensive resource spanning multiple platforms, with thousands of pages added. With its expanding reach across the FOSS scene, TLDR Pages owes its success to the countless contributors and maintainers who have dedicated their time and expertise to the project. Thank you for your invaluable contributions. Here's to another ten years of making knowledge accessible and empowering command-line users globally!

Calling all maintainers of both clients and tldr alike! Since the previous [v2.0](https://github.com/tldr-pages/tldr/releases/tag/v2.0) release, substantial work has been going on behind the scenes to improve `tldr`, spanning from new platforms additions to adding l10n support for tldr book. With this minor release, we are introducing a newer version of client specification with multiple fixes to existing sections. ## Client Specification ### Changelog 📜 - Add requirement to support escaping the placeholder syntax in certain pages ([#10730](https://github.com/tldr-pages/tldr/pull/10730)) (thanks @acuteenvy) - Add suggestion to detect new platforms added to the relevant `pages` directory automatically ([#11523](https://github.com/tldr-pages/tldr/pull/11523)) (thanks @kbdharun) ## Updates ### Platform additions: BSD 💻 We have added support for FreeBSD, NetBSD and OpenBSD platforms to the [`pages` directory](https://github.com/tldr-pages/tldr/tree/v2.1/pages). Currently, it contains a small subset of package manager commands. If you use any BSD platform-specific commands, we suggest creating a PR to add them to the subdirectories. ### PDF changes #### Tldr book is now available in your language 🎉 We have added support for generating tldr book PDFs for translations in our CI with a new `build-pdf`script ([#10969](https://github.com/tldr-pages/tldr/pull/10969)). The default font of the pages was updated to Noto Sans to support additional languages. The PDF files contain rendered tldr pages from your `pages.<locale>` directory sorted platform-wise. They are available [here](https://github.com/tldr-pages/tldr-pages.github.io/tree/main/assets) and are also visible on our website at `https://tldr.sh/assets/tldr-book-<locale>.pdf`. (**Note**: tldr book PDFs will not be available in a few languages due to rendering issues upon generation.) #### Platform-specific PDF creation We have added support to create platform-specific PDF pages in the [`render.py`](https://github.com/tldr-pages/tldr/tree/main/scripts/pdf) script. (https://github.com/tldr-pages/tldr/pull/11195) (thanks @kbdharun) ### General Updates - There have been numerous improvements throughout our test suite and action workflows. (thanks to @sebastiaanspeck) - We have added a symlink for `pages` directory to `pages.en`. ([#11139](https://github.com/tldr-pages/tldr/pull/11139)) (thanks @acuteenvy) For more updates, check out the [tracker issue](https://github.com/tldr-pages/tldr/issues/11146). ---- Last month we had a successful hacktoberfest, with more than 400+ PR merged from dozens of contributors. Thanks to all the contributors and maintainers for their contributions.

Calling all maintainers of both clients and tldr alike! Since [v1.5b](https://github.com/tldr-pages/tldr/releases/tag/v1.5b) release, the `master` branch was removed. The clients that haven't updated got moved to a [dedicated section in the wiki](https://github.com/tldr-pages/tldr/wiki/tldr-pages-clients#currently-broken-clients-and-integrations). If you are a user of any of these clients, we highly recommend migrating to [a supported community client or one of our official clients](https://github.com/tldr-pages/tldr/wiki/tldr-pages-clients). ## Client authors ### Changelog This version of [CLIENT SPECIFICATION](https://github.com/tldr-pages/tldr/blob/v2.0/CLIENT-SPECIFICATION.md) introduces the following changes: - Add recommendation to support macos alias for osx (https://github.com/tldr-pages/tldr/pull/7514) (thanks @MasterOdin) - Drop the special "all" platform from the --list flag (https://github.com/tldr-pages/tldr/pull/7561) (thanks @dbrgn) - Drop the master branch from the assets link. (https://github.com/tldr-pages/tldr/pull/9668) (thanks @MasterOdin) - Require support for long options (https://github.com/tldr-pages/tldr/pull/9651) (thanks @pixelcmtd) - Add recommendation to support caching individual translation archives (https://github.com/tldr-pages/tldr/pull/10148) (thanks @kbdharun) ### Requiring support for long options Clients will be required to add support for long options for commands along with short options for a more uniform experience. ### Introducing caching support for individual translation archives for each language Addressing the community's requests, we have added support for individual language-specific translation archives in <https://github.com/tldr-pages/tldr/pull/10555> (thanks @adamazing). If your client displays pages based on the user's language configuration from the cache, now you can include the selected language along with English as a fallback to save space from unused languages. Complete language archives will still be available for clients using it. ## tldr Maintainers Dependabot alerts and CodeQL analysis got enabled on compatible repositories org-wide. ## Community Updates - The primary chatroom address has been updated to [#tldr-pages:matrix.org](https://matrix.to/#/#tldr-pages:matrix.org). The old Gitter chatroom address was added as an alternate published address. - Last year, we faced an incident with the CLA [bot], where we fixed the title of our project in the GitHub Gist that invalidated any previously signed CLAs of existing contributors. We are sorry for the inconvenience caused, and we suggest resigning the CLA when you contribute again. - The domain <https://tldr.sh> has been verified in the [tldr-pages GitHub organization](https://github.com/tldr-pages). (thanks @agnivade) - We are now on Fediverse. We have created a new account on Fosstodon (A @mastodon instance for FOSS projects). Feel free to check out <https://fosstodon.org/@tldr_pages>. (thanks @sbrl) - The live demo web client on the official website has been updated (<https://github.com/tldr-pages/tldr-pages.github.io/pull/65>) to use <https://tldr.inbrowser.app>. (thanks @rwv) - New maintainers and members got added with other role transitions, check out [MAINTAINERS.md](https://github.com/tldr-pages/tldr/blob/v2.0/MAINTAINERS.md) for more information. Last year's Hacktoberfest was one of the biggest for tldr-pages, with more than 700 PRs merged from 240+ contributors🎉 . We are excited for this year's Hacktoberfest next month. Thanks to all the contributors and maintainers for their contributions.