diff --git a/content/images/jan-2024.jpg b/content/images/jan-2024.jpg new file mode 100644 index 00000000..cad5ba8e Binary files /dev/null and b/content/images/jan-2024.jpg differ diff --git a/content/images/posts/screenshot-new-website.png b/content/images/posts/screenshot-new-website.png new file mode 100644 index 00000000..ec953ee2 Binary files /dev/null and b/content/images/posts/screenshot-new-website.png differ diff --git a/content/posts/2022-war-in-ukraine.rst b/content/posts/2022-war-in-ukraine.rst deleted file mode 100644 index 02e6e3d7..00000000 --- a/content/posts/2022-war-in-ukraine.rst +++ /dev/null @@ -1,55 +0,0 @@ -War in Ukraine and what it means for Read the Docs -################################################## - -:date: March 7, 2022 -:category: News -:tags: stats, year-in-review, homepage -:authors: David Fischer -:description: With news surrounding the invasion of Ukraine evolving rapidly, we felt it was necessary to provide an update. -:status: draft -:image: -:image_credit: - -With news surrounding the invasion of Ukraine evolving rapidly, -we felt it was necessary to provide an update to our users and customers. - -At Read the Docs, we are outraged and saddened by the invasion of Ukraine -and we condemn this act of violence as wrong and unlawful. -We are monitoring the situation in Europe -and how it relates to our employees, customers, and our services to the open source world. - -Read the Docs is a very small company, with only seven employees, -and fortunately none of them are currently in harm's way. -Our impact on the open source ecosystem, however, is bigger than our size, -and we have users all over the world, including in Ukraine and Russia. - - -Impact on our services ----------------------- - -We are continuing to monitor news that could potentially affect our users, -including sanctions applied to the region. - -Read the Docs is currently partially blocked in Russia by the Russian government. -While we are working to resolve this, -it does not appear that this block is related to war in Ukraine. - -Other than this government block and potential effects from financial sanctions, our services are not impacted. -Read the Docs is hosted and incorporated in the United States, -and so any further changes to US sanctions would apply to our services. - - -What we are doing and what you can do -------------------------------------- - -As the situation develops, we will be transparent about any actions we take. -We take our role of helping the open source community with documentation seriously -and we aim to be a platform for all developers. - -Over the coming days, our advertising arm `EthicalAds `_ -will be running a series of community ads aimed at raising money -for the `United Nations Crisis Relief Fund `_ -and other missions aimed at humanitarian aid for Ukraine. -If you can donate to help provide humanitarian aid, please do. - -We are hoping that peace is restored as quickly as possible. diff --git a/content/posts/newsletter-january-2024.rst b/content/posts/newsletter-january-2024.rst new file mode 100644 index 00000000..2370b4ea --- /dev/null +++ b/content/posts/newsletter-january-2024.rst @@ -0,0 +1,46 @@ +:title: Read the Docs Newsletter - January 2024 +:date: Jan 10, 2024 +:tags: newsletter, python +:category: Newsletter +:author: Eric +:image: /images/jan-2024.jpg +:image_credit: Photo by Glen Carrie on Unsplash + + +Read the Docs newsletter - January 2024 +======================================== + +News and updates +---------------- + +* We have shipped `new redirects `_, making our redirects much more powerful and flexible. +* We have shipped an `updated approach to notifications `_. Currently there isn't much UX difference, but as we move forward with this project we will be able to provide more context and control to users. +* We continue to work on improving Addons, our new approach to documentation integrations. New documentation and bug fixing continues to happen. +* We shipped version 2.0 of our `Read the Docs Sphinx Theme `_, which adds support for new Sphinx releases and drops support for many old versions of Sphinx and Python. + +You can always see the latest changes to our platforms in our `Read the Docs Changelog `_. + +Upcoming changes +---------------- + +* Addons will be made more configurable in our new beta dashboard, starting a trend of moving away from the old dashboard for new features. +* Our `beta dashboard `_ continues to be tested in public beta, and new functionality for Addons configuration will only be available in that new interface. +* We continue to work on some business model changes enabled by the new redirects work, including allowing access to Forced Redirects for more users. + +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 + +Possible issues +--------------- + +* Users need to `update their webhooks `_ before **January 31, 2024** if they are configured without a secret. All users who need to take action should have received email and site notifications about this. +* We are discussing removing support for all VCS systems except Git, as our userbase is heavily biased towards Git users and it will simplify maintenance and development of features. We stopped developing features for Mercurial, Subversion, and Bazaar years ago, and we are considering removing support for them entirely. We will be reaching out to these users to get feedback on this change. + +------- + +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 diff --git a/content/posts/read-the-docs-2021-stats.rst b/content/posts/read-the-docs-2021-stats.rst index 7579ce7d..aeca9744 100644 --- a/content/posts/read-the-docs-2021-stats.rst +++ b/content/posts/read-the-docs-2021-stats.rst @@ -6,8 +6,8 @@ Read the Docs 2021 Stats :tags: stats, year-in-review, homepage :authors: Eric Holscher, David Fischer :description: 2021 continued in the realm of being a tough year. That said, Read the Docs had a lot of good things happen this year. -:status: draft -:image: +:status: published +:image: :image_credit: 2021 continued in the realm of being a tough year. diff --git a/content/posts/website-migration.rst b/content/posts/website-migration.rst new file mode 100644 index 00000000..620b45ca --- /dev/null +++ b/content/posts/website-migration.rst @@ -0,0 +1,63 @@ +Read the Docs website migration +=============================== + +:date: Mar 9, 2023 +:category: Changelog +:tags: website, migration +:authors: Eric Holscher +:description: Read the Docs has a new home for website and content pages that were previously part of our application. +:status: published +:image: /images/posts/screenshot-new-website.png +:image_credit: + +Read the Docs is in the process of migrating our primary marketing website to a single site: https://about.readthedocs.com. +The new site offers users more information about our products and their features, +in a combined presentation of what was previously divided between two websites (Read the Docs Community and Read the Docs for Business). +At the same time, the new site will also serve as a single entrypoint for users that are logging in to Read the Docs accounts. +There has been a good deal of confusion around our two sites, +and this change makes it more clear which site you're going to. + +Importantly, +**we are keeping both our Community and Business sites separate for logged in users.** +There are no changes in our commitment to offering free hosting for open source, +or the separation of infrastructure for Business customers. + +Marketing website migration process +----------------------------------- + +The process that we're taking to migrate our marketing site is as follows: + +#. ✅ The initial work here was creating a proper marketing site, + and deploying it to https://about.readthedocs.com. + This was done in January 2023. +#. ✅ Redirecting *logged out* Business (``readthedocs.com``) users to the new site. + This was done in February 2023, and we've been monitoring the impact of this change. +#. ✅ Redirect *logged out* Community (``readthedocs.org``) users to the new site. + This was done in August 2023, to make sure the experience is smooth for users who are used to our application web pages. + +We're excited about our new website, +because historically we have done a poor job of explaining our products. +Being able to have a single site that explains the features of our various sites, +and the value that Read the Docs brings to the documentation ecosystem is exciting for us. + +Technical details +----------------- + +Historically, +our marketing pages were generated from our Django application, +and updated only when we deployed a new version of the site. +With our new approach, +our marketing site is actually hosted by Read the Docs itself. + +Self-hosting our marketing website gives us many benefits that our users love about hosting their docs with us: + +* A proper static site generator built for making a website and blog. +* Pull request previews to allow us to review content changes. +* Instant deployment of updates whenever we merge to ``main``. +* All the rest of our features that we offer to our users. + +We're using our new build customization features to build our site with `Pelican `__, +and it's been a really fun way to expand the capabilities of our build system. + +We hope that you'll join us for the next stage of Read the Docs, +where we will continue to provide the best documentation hosting for all software projects.