https://blog.readthedocs.comRead the Docs Blog - Posts by Anthony Johnson2024-01-10T23:05:10.197667+00:00ABloghttps://blog.readthedocs.com/newsletter-september-2023/Read the Docs newsletter - September 20232023-09-05T00:00:00+00:00Anthony Johnson<section id="read-the-docs-newsletter-september-2023">
<section id="news-and-updates">
<h2>News and updates</h2>
<ul>
<li><p>🚀 <a class="reference internal" href="../../../addons-flyout-menu-beta/"><span class="doc">We started testing a new flyout menu</span></a>
as part of our beta test for documentation addons.
The beta test is currently limited to projects using the <code class="docutils literal notranslate"><span class="pre">build.commands</span></code>
configuration key.</p></li>
<li><p>🛣️ We continue to have a number deprecations in progress.
We announced this month deprecations of <a class="reference internal" href="../../../drop-support-system-packages/"><span class="doc">installing using system packages</span></a>,
<a class="reference internal" href="../../../use-build-os-config/"><span class="doc">the configuration key build.image</span></a>,
and <a class="reference internal" href="../../../defaulting-latest-build-tools/"><span class="doc">installation of pinned versions of Sphinx and MkDocs</span></a>.
Keep an eye on your email for any deprecation notifications,
as we will continue to notify maintainers of projects that might be impacted.</p></li>
<li><p>📚 The Read the Docs Sphinx theme package, <code class="docutils literal notranslate"><span class="pre">sphinx-rtd-theme</span></code>, had two releases.
Version 1.3.0 was released, adding support for Sphinx 7.0.
Version 2.0.0rc2 is also now out.
This is a release candidate that will remove support for HTML4 output and will drop support for Sphinx versions prior to 5.0.
We will be announcing the release candidate more this month and will be looking to have feedback from users.</p></li>
<li><p>🔐 <a class="reference external" href="https://github.com/readthedocs/readthedocs.org/security/advisories/GHSA-v7x4-rhpg-3p2r">A security advisory involving symlink abuse</a> during project builds was raised and patched.</p></li>
<li><p>📉 Changes to our request handling resulted in a 30% reduction in response times for 404 error responses.</p>
<blockquote>
<div><figure class="align-default" id="id1">
<img alt="../../../_images/2023-september-404.png" src="../../../_images/2023-september-404.png" />
<figcaption>
<p><span class="caption-text">Request times for 404 handling have dropped 30% since last release.</span></p>
</figcaption>
</figure>
</div></blockquote>
</li>
<li><p>🏁 Updates to Proxito are now fully rolled out to Read the Docs Community and Read the Docs for Business.</p></li>
<li><p>✨ We upgraded our application to use Django 4.2.</p></li>
</ul>
</section>
<section id="upcoming-changes">
<h2>Upcoming changes</h2>
<ul class="simple">
<li><p>⚠️ In line with <a class="reference internal" href="../../../migrate-configuration-v2/"><span class="doc">our deprecation plans for builds without a configuration file</span></a>,
projects will be required to specify a configuration file to continue building their documentation starting September 25th.
Our last brownout date is September 4th, lasting 48 hours.
To avoid any problems building your project,
ensure it has a configuration file before then.</p></li>
<li><p>🚢️ We will be continuing our work on for our beta test of <a class="reference external" href="https://github.com/readthedocs/addons">Read the Docs Addons</a>.
Our focus is still on improving the new flyout menu, search, and adding more new features.</p></li>
<li><p>🛠️ Our new dashboard, currently available for beta testing at <a class="reference external" href="https://beta.readthedocs.org">https://beta.readthedocs.org</a>,
will receive some small feature additions, and we are working towards a beta of the new dashboard for Read the Docs for Business as well.
We expect to have more news here in the coming months.</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 class="simple">
<li><p>⚠️ Make sure to follow directions from notifications regarding deprecations.
We have notified project maintainers for any project that could be affected by one of our ongoing deprecations.
Updating your package ahead of brownout dates and final deprecation cutoff dates will ensure your project continues to successfully build.</p></li>
</ul>
<hr class="docutils" />
<p>Questions? Comments? Ideas for the next newsletter? <a class="reference external" href="mailto:hello%40readthedocs.org">Contact us</a>!</p>
</section>
</section>
🚀 We started testing a new flyout menu
as part of our beta test for documentation addons.
The beta test is currently limited to projects using the build.commands
configuration key.🛣️ We continue to have a number deprecations in progress.
We announced this month deprecations of installing using system packages,
the configuration key build.image,
and installation of pinned versions of Sphinx and MkDocs.
Keep an eye on your email for any deprecation notifications,
as we will continue to notify maintainers of projects that might be impacted.2023-09-05T00:00:00+00:00