How-to guides: best practices ============================= Over the years, we have become familiar with a number of methods that work well and which we consider **best practice**. ⏩️ :doc:`Best practices for linking to your documentation ` Documentation changes over time, and links and cross-references can become challenging manage for various reasons. Here is a set of best practices explaining and addressing these challenges. ⏩️ :doc:`Deprecating content ` Best practice for removing or deprecating documentation content. ⏩️ :doc:`Creating reproducible builds ` Every documentation project has dependencies that are required to build it. Using an unspecified versions of these dependencies means that your project can start breaking. In this guide, learn how to protect your project against breaking randomly. **This is one of our most popular guides!** ⏩️ :doc:`Search engine optimization (SEO) for documentation projects ` This article explains how documentation can be optimized to appear in search results, increasing traffic to your docs. ⏩️ :doc:`Hiding a version ` Learn how you can keep your entire version history online without overwhelming the reader with version choices. .. toctree:: :maxdepth: 1 :hidden: Deprecating content Best practices for linking to your documentation Creating reproducible builds Search engine optimization (SEO) for documentation projects Hiding a version