https://blog.readthedocs.com 2023-07-08T10:50:29.842428+00:00 ABlog https://blog.readthedocs.com/newsletter-july-2023/ 2023-07-06T00:00:00+00:00 Eric Holscher <section id="read-the-docs-newsletter-july-2023"> <section id="news-and-updates"> <h2>News and updates</h2> <ul class="simple"> <li><p>🚀 We shipped support for customizing the URL path for projects and subprojects, allowing you to remove or customize the <cite>/projects/</cite> path on subprojects. This is enabled via Support request currently, and only on certain plans on Read the Docs for Business.</p></li> <li><p>🛣️ Deprecations underway: We have a number of old feature deprecations underway. The goal here is to reduce complexity of our build platform, and enable users to control their own builds via <code class="docutils literal notranslate"><span class="pre">build.tools</span></code> and <code class="docutils literal notranslate"><span class="pre">build.commands</span></code> instead of feature flags. Keep an eye on your email for any deprecation notifications that might impact your project.</p></li> <li><p>📧️ Getting too many deprecation notifications? We added the ability to opt out of email notifications. You can configure this in your user profile settings.</p></li> <li><p>✅️ New tool updates for all build tools, including the latest stable versions of Python, PyPy, Node.js, Rust and Go. See the documentation of the <a class="reference external" href="https://docs.readthedocs.io/page/config-file/v2.html#build-tools">build.tools</a> for more info.</p></li> <li><p>📚️ A new documentation how-to for <code class="docutils literal notranslate"><span class="pre">.readthedocs.yaml</span></code> was started at <a class="reference external" href="https://www.writethedocs.org/">Write the Docs</a> and finished recently. Read it here: <a class="reference external" href="https://docs.readthedocs.io/en/stable/guides/setup/configuration-file.html" title="(in Read the Docs user documentation v9.15.0)"><span>How to add a configuration file</span></a>.</p></li> <li><p>⏩️ HTTP speedups: Several HTTP endpoints and CloudFlare configurations have been tweaked and are performing better.</p></li> <li><p>🐛️ Bug fix: We are now 100% relying on search indexing by parsing HTML, instead of special Sphinx-only logic. This makes search a lot simpler and more consistent for our users.</p></li> </ul> </section> <section id="upcoming-features"> <h2>Upcoming features</h2> <ul> <li><p>⏩️ Our build process is receiving considerable improvements for larger Git repositories. The <code class="docutils literal notranslate"><span class="pre">git</span> <span class="pre">clone</span></code> and <code class="docutils literal notranslate"><span class="pre">git</span> <span class="pre">fetch</span></code> operations are tweaked, which results in significant speedups. For instance, the CPython project now fetches its Git repository at nearly 10x the speed of before. The change is being deployed soon to a few select projects and then gradually rolled out. For more details, see <a class="reference external" href="https://github.com/readthedocs/readthedocs.org/issues/9736">issue #9736</a>.</p></li> <li><p>🚢️ We have concluded work on the first phase of our new <a class="reference external" href="https://github.com/readthedocs/readthedocs-client">Read the Docs Addons</a>. Our Addons will be a single library for all the ways Read the Docs enhances documentation. There will be integration points and APIs to customize all of these features in the new client.</p> <p>We will start to use it on a few selected projects. If you are interested in having it enabled on your project, please <a class="reference external" href="https://readthedocs.org/support/">reach out</a>.</p> </li> </ul> <p>Want to follow along with our development progress? <a class="reference external" href="https://github.com/orgs/readthedocs/projects/156/views/1">View our full Roadmap 📍️</a></p> </section> <section id="possible-issues"> <h2>Possible issues</h2> <ul> <li><p>⚠️ Please make sure to read the blog post: <a class="reference internal" href="../../../migrate-configuration-v2/"><span class="doc">Migrate your project to .readthedocs.yaml configuration file v2</span></a>.</p> <p>If you didn’t have a <code class="docutils literal notranslate"><span class="pre">.readthedocs.yaml</span></code> configuration file, and you are introducing one for the first time, we’re excited for you to be able to use all our new features like specifying build tool versions (Node, Rust, etc.)!</p> <p>The blog post offers help with that 💡️</p> </li> </ul> </section> <section id="awesome-project-of-the-month"> <h2>Awesome project of the month</h2> <p>We are adding new entries to the list of <a class="reference external" href="https://github.com/readthedocs-examples/awesome-read-the-docs">Awesome Read the Docs Projects 🕶️</a>. Feel free to open an issue or pull request if you’ve seen something that might inspire others.</p> <p>This month’s addition is <a class="reference external" href="https://docs.django-cms.org/">the developer documentation for django-cms</a>, which is noted for being both extremely extensive and well-organized at the same time. It uses the <a class="reference external" href="https://pradyunsg.me/furo/quickstart/">Furo</a> theme that has full integration with Read the Docs’ reader extensions.</p> <hr class="docutils" /> <p>Questions? Comments? Ideas for the next newsletter? <a class="reference external" href="mailto:hello&#37;&#52;&#48;readthedocs&#46;org">Contact us</a>!</p> </section> </section>

🚀 We shipped support for customizing the URL path for projects and subprojects, allowing you to remove or customize the /projects/ path on subprojects. This is enabled via Support request currently, and only on certain plans on Read the Docs for Business.🛣️ Deprecations underway: We have a number of old feature deprecations underway. The goal here is to reduce complexity of our build platform, and enable users to control their own builds via build.tools and build.commands instead of feature flags. Keep an eye on your email for any deprecation notifications that might impact your project.

2023-07-06T00:00:00+00:00