Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Add Sept 2023 newsletter #241

Merged
merged 5 commits into from
Sep 5, 2023
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
1 change: 1 addition & 0 deletions .gitignore
Original file line number Diff line number Diff line change
Expand Up @@ -3,3 +3,4 @@ _build
*.pyc
.python-version
.ropeproject/
.direnv/
Binary file added img/2023-september-404.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
80 changes: 80 additions & 0 deletions newsletter-september-2023.rst
Original file line number Diff line number Diff line change
@@ -0,0 +1,80 @@
.. post:: September 5, 2023
:tags: newsletter, python
:author: Anthony
:location: GEG
:category: Newsletter

Read the Docs newsletter - September 2023
=========================================

News and updates
----------------

- 🚀 :doc:`We started testing a new flyout menu </addons-flyout-menu-beta>`
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 :doc:`installing using system packages </drop-support-system-packages>`,
:doc:`the configuration key build.image </use-build-os-config>`,
and :doc:`installation of pinned versions of Sphinx and MkDocs </defaulting-latest-build-tools>`.
Keep an eye on your email for any deprecation notifications,
as we will continue to notify maintainers of projects that might be impacted.

- 📚 The Read the Docs Sphinx theme package, ``sphinx-rtd-theme``, 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.

- 🔐 `A security advisory involving symlink abuse`_ during project builds was raised and patched.

- 📉 Changes to our request handling resulted in a 30% reduction in response times for 404 error responses.

.. figure:: /img/2023-september-404.png

Request times for 404 handling have dropped 30% since last release.

- 🏁 Updates to Proxito are now fully rolled out to |org_brand| and |com_brand|.

- ✨ We upgraded our application to use Django 4.2.

.. _A security advisory involving symlink abuse: https://github.com/readthedocs/readthedocs.org/security/advisories/GHSA-v7x4-rhpg-3p2r

Upcoming changes
----------------

- ⚠️ In line with :doc:`our deprecation plans for builds without a configuration file </migrate-configuration-v2>`,
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.

- 🚢️ We will be continuing our work on for our beta test of `Read the Docs Addons <https://github.com/readthedocs/addons>`__.
Our focus is still on improving the new flyout menu, search, and adding more new features.

- 🛠️ Our new dashboard, currently available for beta testing at https://beta.readthedocs.org,
will receive some small feature additions, and we are working towards a beta of the new dashboard for |com_brand| as well.
We expect to have more news here in the coming months.

Want to follow along with our development progress? `View our full roadmap 📍️`_

.. _View our full roadmap 📍️: https://github.com/orgs/readthedocs/projects/156/views/1
.. _reach out: https://readthedocs.org/support/

Possible issues
---------------

- ⚠️ 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.

-------

Questions? Comments? Ideas for the next newsletter? `Contact us`_!

.. Keeping this here for now, in case we need to link to ourselves :)

.. _Contact us: mailto:hello@readthedocs.org