Skip to content

Commit 2b61915

Browse files
authored
Initial August 2023 Newsletter draft (#234)
* Initial August 2023 Newsletter draft * Fix build with same rst_epilog as in .org so we can refernece the sites easily * Address feedback * Ship today
1 parent a05e582 commit 2b61915

File tree

2 files changed

+60
-0
lines changed

2 files changed

+60
-0
lines changed

conf.py

+8
Original file line numberDiff line numberDiff line change
@@ -433,3 +433,11 @@
433433

434434
# If false, no index is generated.
435435
#epub_use_index = True
436+
437+
# See dev/style_guide.rst for documentation
438+
rst_epilog = """
439+
.. |org_brand| replace:: Read the Docs Community
440+
.. |com_brand| replace:: Read the Docs for Business
441+
.. |git_providers_and| replace:: GitHub, Bitbucket, and GitLab
442+
.. |git_providers_or| replace:: GitHub, Bitbucket, or GitLab
443+
"""

newsletter-august-2023.rst

+52
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,52 @@
1+
.. post:: August 3, 2023
2+
:tags: newsletter, python
3+
:author: Eric
4+
:location: BND
5+
:category: Newsletter
6+
7+
Read the Docs newsletter - August 2023
8+
======================================
9+
10+
News and updates
11+
----------------
12+
13+
- 🏝️ A few team members took vacations this month, and everything kept running smoothly, which is always wonderful to see.
14+
- ⏩ Our `git cloning code <https://github.com/readthedocs/readthedocs.org/pull/10430>`_ was refactored, and now projects should be building much faster. The more git branches and tags you have, the faster the build will be.
15+
- 🆕 All new projects imported on Read the Docs get the latest versions of our default documentation tools installed. This is the goal of our large set of deprecations lately, and now all new projects are starting in a place where we want all projects to get to.
16+
- 💵 We are working to simplify our subscriptions on |com_brand|, to make it easier for customers to know what they are getting, and for us to ensure all the features in each plan align with our pricing page.
17+
- 🔒 We shipped a `change to authentication <https://github.com/readthedocs/readthedocs.org/pull/10498>`_ on our build servers to dramatically reduce the permissions required when building documentation.
18+
This increases our "defense in depth" security posture, and reduces the risk of a security breach.
19+
20+
You can always see the latest changes to our platforms in our `changelog <https://docs.readthedocs.io/page/changelog.html>`_.
21+
22+
Upcoming features
23+
-----------------
24+
25+
- Our marketing website (https://about.readthedocs.com/) transition will be finishing up next week.
26+
We will be redirecting all logged out |org_brand| users to the new site, completing this migration.
27+
- We continue to finish rolling out our updated Proxito v2 code. This is fully rolled out to |org_brand|,
28+
and has a couple customers we're waiting on to migrate |com_brand|. This will happen in August.
29+
- We are rolling out HTML search indexing for all projects. This removes a small bit of functionality from our search for Sphinx projects,
30+
but makes it much more reliable across all documentation tools.
31+
- We continue to work on a revamped flyout using our `addons <https://github.com/readthedocs/addons>`_ system.
32+
This is the first step in a larger project to improve the user experience of our documentation platform.
33+
34+
Want to follow along with our development progress? `View our full Roadmap 📍️`_
35+
36+
.. _View our full Roadmap 📍️: https://github.com/orgs/readthedocs/projects/156/views/1
37+
38+
Possible issues
39+
---------------
40+
41+
- Continuing deprecations:
42+
We have a number of old feature deprecations underway.
43+
The goal here is to reduce complexity of our build platform,
44+
and enable users to control their own builds via ``build.tools`` and ``build.commands`` instead of feature flags.
45+
You can see the full list and timeline on `issue #10587 <https://github.com/readthedocs/readthedocs.org/issues/10587>`_ & `issue #9779 <https://github.com/readthedocs/readthedocs.org/issues/9779>`_.
46+
47+
-------
48+
49+
Questions? Comments? Ideas for the next newsletter? `Contact us`_ or just reply to this email.
50+
51+
.. _Contact us: mailto:[email protected]
52+

0 commit comments

Comments
 (0)