https://blog.readthedocs.comRead the Docs Blog - Posts from Malmö, Sweden2024-01-10T23:05:10.560052+00:00ABloghttps://blog.readthedocs.com/newsletter-june-2023/Read the Docs newsletter - June 20232023-06-05T00:00:00+00:00Benjamin Balder Bach<section id="read-the-docs-newsletter-june-2023">
<section id="news-and-updates">
<h2>News and updates</h2>
<ul class="simple">
<li><p>⚠️ A <code class="docutils literal notranslate"><span class="pre">.readthedocs.yaml</span></code> configuration file will be required for your future builds.
Read more about this change in <a class="reference internal" href="../../../migrate-configuration-v2/"><span class="doc">Migrate your project to .readthedocs.yaml configuration file v2</span></a>.</p></li>
<li><p>✅️ Visiting a language slug of a project without specifying the version now redirects to the default version.
For instance, <code class="docutils literal notranslate"><span class="pre">/en/</span></code> redirects to <code class="docutils literal notranslate"><span class="pre">/en/latest/</span></code>.</p></li>
<li><p>🍿️ All the talks from <a class="reference external" href="https://www.writethedocs.org/conf/portland/2023/">Write the Docs Portland 2023</a>, which we sponsored this year, are ready to watch:
<a class="reference external" href="https://www.youtube.com/watch?v=EZJ0mk9Jj3s&list=PLZAeFn6dfHpneQPsDWa4OmEpgW4pNiaZ2">Open the new playlist on Youtube</a>.</p></li>
<li><p>🐛️ Builds with multiline <code class="docutils literal notranslate"><span class="pre">build.commands</span></code> should now be <a class="reference external" href="https://github.com/readthedocs/readthedocs.org/issues/10103">working reliably</a>.
Thanks to everyone who helped out!</p></li>
<li><p>🐛️ <a class="reference external" href="https://sphinx-rtd-theme.readthedocs.io/en/stable/changelog.html">sphinx-rtd-theme 1.2.1</a> has been released with an important bug fix that caused jQuery to not load in certain projects.</p></li>
<li><p>🔒️ We updated custom domain certificates to 1.2 as the <em>minimum</em> TLS version.</p></li>
<li><p>🔒️ A high-severity vulnerability has been fixed:
<a class="reference external" href="https://github.com/readthedocs/readthedocs.org/security/advisories/GHSA-rqfv-8rrx-prmh">Write access to projects via API V2 (/api/v2/project/* endpoints) for any logged-in user</a>.</p></li>
</ul>
</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>The most recent addition to
<a class="reference external" href="https://github.com/readthedocs-examples/awesome-read-the-docs">Awesome Read the Docs Projects 🕶️</a>
is <a class="reference external" href="https://docs.ray.io/">Ray’s documentation</a> 🕶️.</p>
<p>Ray is an open source project, consisting of several components that all have their own section in a combined documentation set.</p>
<p>See the highlights in the following
<a class="reference external" href="https://twitter.com/readthedocs/status/1663923671470047234">Twitter thread</a> or
<a class="reference external" href="https://fosstodon.org/@readthedocs/110463989114312961">Mastodon thread</a>:</p>
<blockquote class="twitter-tweet"><p lang="en" dir="ltr">The most recent addition to our awesome projects list is Ray's documentation 🕶️.<br><br>Ray by <a href="https://twitter.com/anyscalecompute?ref_src=twsrc%5Etfw">@anyscalecompute</a> is an open source project, consisting of several components that all have their own section in a combined documentation set.<a href="https://t.co/9YGpJvYpFD">https://t.co/9YGpJvYpFD</a><br><br>Here is a 🤏 (small) 🧵 <a href="https://t.co/QElmmJetPB">pic.twitter.com/QElmmJetPB</a></p>— Read the Docs (@readthedocs) <a href="https://twitter.com/readthedocs/status/1663923671470047234?ref_src=twsrc%5Etfw">May 31, 2023</a></blockquote> <script async src="https://platform.twitter.com/widgets.js" charset="utf-8"></script><figure class="align-default" id="id1">
<img alt="A screenshot of a sample .readthedocs.yaml file" src="../../../_images/screenshot-readthedocs-yaml.png" />
<figcaption>
<p><span class="caption-text">It was always better to use a <code class="docutils literal notranslate"><span class="pre">.readthedocs.yaml</span></code> file.
It gives so many more options and makes it possible to version your configuration in your Git repository ⚡️</span></p>
</figcaption>
</figure>
<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>
⚠️ A .readthedocs.yaml configuration file will be required for your future builds.
Read more about this change in /migrate-configuration-v2.✅️ Visiting a language slug of a project without specifying the version now redirects to the default version.
For instance, /en/ redirects to /en/latest/.2023-06-05T00:00:00+00:00