Changelogļƒ

Version 10.11.0ļƒ

Date:

November 14, 2023

Version 10.10.0ļƒ

Date:

November 07, 2023

Version 10.9.0ļƒ

Date:

October 31, 2023

Version 10.8.1ļƒ

Date:

October 24, 2023

Version 10.8.0ļƒ

Date:

October 24, 2023

Version 10.7.1ļƒ

Date:

October 17, 2023

Version 10.7.0ļƒ

Date:

October 10, 2023

Version 10.6.1ļƒ

Date:

October 03, 2023

Version 10.6.0ļƒ

Date:

September 26, 2023

Version 10.5.0ļƒ

Date:

September 18, 2023

Version 10.4.0ļƒ

Date:

September 12, 2023

Version 10.3.0ļƒ

Date:

September 05, 2023

Version 10.2.0ļƒ

Date:

August 29, 2023

Version 10.1.0ļƒ

Date:

August 22, 2023

Version 10.0.0ļƒ

This release is a Django 4.2 upgrade, so it has a major version bump, 10.0!

Date:

August 14, 2023

Version 9.16.4ļƒ

Date:

August 08, 2023

Version 9.16.3ļƒ

Date:

August 01, 2023

Version 9.16.2ļƒ

Date:

July 25, 2023

Version 9.16.1ļƒ

Date:

July 17, 2023

Version 9.16.0ļƒ

Date:

July 11, 2023

Version 9.15.0ļƒ

Date:

June 26, 2023

Version 9.14.0ļƒ

Date:

June 20, 2023

Version 9.13.3ļƒ

Date:

June 13, 2023

Version 9.13.2ļƒ

Date:

June 06, 2023

Version 9.13.1ļƒ

Date:

May 30, 2023

Version 9.13.0ļƒ

Date:

May 23, 2023

Version 9.12.0ļƒ

Date:

May 02, 2023

Version 9.11.0ļƒ

Date:

April 18, 2023

Version 9.10.1ļƒ

Date:

April 11, 2023

Version 9.10.0ļƒ

Date:

March 28, 2023

Version 9.9.1ļƒ

Date:

March 21, 2023

Version 9.9.0ļƒ

Date:

March 14, 2023

Version 9.8.0ļƒ

Date:

March 07, 2023

Version 9.7.0ļƒ

This release contains one security fix. For more information, see:

Date:

February 28, 2023

Version 9.6.0ļƒ

Date:

February 21, 2023

Version 9.5.0ļƒ

This release contains one security fix. For more information, see:

Date:

February 13, 2023

Version 9.4.0ļƒ

This release contains one security fix. For more information, see:

Date:

February 07, 2023

Version 9.3.1ļƒ

Date:

January 30, 2023

Version 9.3.0ļƒ

Date:

January 24, 2023

Version 9.2.0ļƒ

This release contains two security fixes. For more information, see our GitHub advisories:

Date:

January 16, 2023

Version 9.1.3ļƒ

Date:

January 10, 2023

Version 9.1.2ļƒ

Date:

January 03, 2023

Version 9.1.1ļƒ

Date:

December 20, 2022

Version 9.1.0ļƒ

This release contains an important security fix. See more information on the GitHub advisory.

Date:

December 08, 2022

Version 9.0.0ļƒ

This version upgrades our Search API experience to a v3.

Date:

November 28, 2022

Version 8.9.0ļƒ

Date:

November 15, 2022

Version 8.8.1ļƒ

This release contains a security fix, which is the most important part of the update.

Date:

November 09, 2022

Version 8.8.0ļƒ

Date:

November 08, 2022

Version 8.7.1ļƒ

Date:

October 24, 2022

Version 8.7.0ļƒ

Date:

October 11, 2022

Version 8.6.0ļƒ

Date:

September 28, 2022

Version 8.5.0ļƒ

Date:

September 12, 2022

Version 8.4.3ļƒ

Date:

September 06, 2022

Version 8.4.2ļƒ

Date:

August 29, 2022

Version 8.4.1ļƒ

Date:

August 23, 2022

Version 8.4.0ļƒ

Date:

August 16, 2022

Version 8.3.7ļƒ

Date:

August 09, 2022

  • @stsewd: Sphinx domain: change type of ID field (#9482)

  • @humitos: Build: unpin Pillow for unsupported Python versions (#9473)

  • @humitos: Release 8.3.6 (#9465)

  • @stsewd: Redirects: check only for hostname and path for infinite redirects (#9463)

  • @benjaoming: Fix missing indentation on reStructuredText badge code (#9404)

  • @stsewd: Embed JS: fix incompatibilities with sphinx 6.x (jquery removal) (#9359)

Version 8.3.6ļƒ

Date:

August 02, 2022

Version 8.3.5ļƒ

Date:

July 25, 2022

Version 8.3.4ļƒ

Date:

July 19, 2022

Version 8.3.3ļƒ

Date:

July 12, 2022

Version 8.3.2ļƒ

Date:

July 05, 2022

Version 8.3.1ļƒ

Date:

June 27, 2022

Version 8.3.0ļƒ

Date:

June 20, 2022

  • @humitos: Security: avoid requests with NULL characters (0x00) on GET (#9350)

  • @humitos: Logging: reduce log verbosity (#9348)

  • @humitos: Build: truncate command output (#9346)

  • @stsewd: Update common (#9345)

  • @stsewd: Subscriptions: log subscription id when canceling (#9340)

  • @stsewd: Search: support section titles inside header tags (#9339)

  • @humitos: Local development: use nodemon to watch files instead of watchmedo (#9338)

  • @humitos: EmbedAPI: clean images (src) properly from inside a tooltip (#9337)

  • @humitos: Development: update common/ submodule (#9336)

  • @stsewd: Gold: log if the subscription has more than one item (#9334)

  • @humitos: EmbedAPI: handle special case for Sphinx manual references (#9333)

  • @benjaoming: Add mc client to web container (#9331)

  • @humitos: Translations: migrate tx/config to new clientā€™s version format (#9327)

  • @stsewd: Search: index generic doctype (#9322)

  • @benjaoming: Docs: Improve scoping of two potentially overlapping Triage sections (#9302)

Version 8.2.0ļƒ

Date:

June 14, 2022

Version 8.1.2ļƒ

Date:

June 06, 2022

Version 8.1.1ļƒ

Date:

Jun 1, 2022

Version 8.1.0ļƒ

Date:

May 24, 2022

Version 8.0.2ļƒ

Date:

May 16, 2022

Version 8.0.1ļƒ

Date:

May 09, 2022

Version 8.0.0ļƒ

Date:

May 03, 2022

Note

We are upgrading to Ubuntu 22.04 LTS and also to Python 3.10.

Projects using Mamba with the old feature flag, and now removed, CONDA_USES_MAMBA, have to update their .readthedocs.yaml file to use build.tools.python: mambaforge-4.10 to continue using Mamba to create their environment. See more about build.tools.python at https://docs.readthedocs.io/en/stable/config-file/v2.html#build-tools-python

Version 7.6.2ļƒ

Date:

April 25, 2022

Version 7.6.1ļƒ

Date:

April 19, 2022

Version 7.6.0ļƒ

Date:

April 12, 2022

Version 7.5.1ļƒ

Date:

April 04, 2022

Version 7.5.0ļƒ

Date:

March 28, 2022

Version 7.4.2ļƒ

Date:

March 14, 2022

Version 7.4.1ļƒ

Date:

March 07, 2022

  • @humitos: Upgrade common submodule (#9001)

  • @humitos: Build: RepositoryError message (#8999)

  • @humitos: Requirements: remove django-permissions-policy (#8987)

  • @stsewd: Archive builds: avoid filtering by commands__isnull (#8986)

  • @humitos: Build: cancel error message (#8984)

  • @humitos: API: validate RemoteRepository when creating a Project (#8983)

  • @humitos: Celery: trigger archive_builds frequently with a lower limit (#8981)

  • @pyup-bot: pyup: Scheduled weekly dependency update for week 09 (#8977)

  • @stsewd: MkDocs: allow None on extra_css/extra_javascript (#8976)

  • @stsewd: CDN: avoid cache tags collision (#8969)

  • @stsewd: Docs: warn about custom domains on subprojects (#8945)

  • @humitos: Code style: format the code using darker (#8875)

  • @dogukanteber: Use django-storagesā€™ manifest files class instead of the overriden class (#8781)

  • @nienn: Docs: Add links to documentation on creating custom classes (#8466)

  • @stsewd: Integrations: allow to pass more data about external versions (#7692)

Version 7.4.0ļƒ

Date:

March 01, 2022

Version 7.3.0ļƒ

Date:

February 21, 2022

Version 7.2.1ļƒ

Date:

February 15, 2022

Version 7.2.0ļƒ

Date:

February 08, 2022

Version 7.1.2ļƒ

Date:

January 31, 2022

Version 7.1.1ļƒ

Date:

January 31, 2022

Version 7.1.0ļƒ

Date:

January 25, 2022

Version 7.0.0ļƒ

This is our 7th major version! This is because we are upgrading to Django 3.2 LTS.

Date:

January 17, 2022

Version 6.3.3ļƒ

Date:

January 10, 2022

Version 6.3.2ļƒ

Date:

January 04, 2022

Version 6.3.1ļƒ

Date:

December 14, 2021

Version 6.3.0ļƒ

Date:

November 29, 2021

Version 6.2.1ļƒ

Date:

November 23, 2021

Version 6.2.0ļƒ

Date:

November 16, 2021

Version 6.1.2ļƒ

Date:

November 08, 2021

Version 6.1.1ļƒ

Date:

November 02, 2021

Version 6.1.0ļƒ

Date:

October 26, 2021

Version 6.0.0ļƒ

Date:

October 13, 2021

This release includes the upgrade of some base dependencies:

  • Python version from 3.6 to 3.8

  • Ubuntu version from 18.04 LTS to 20.04 LTS

Starting from this release, all the Read the Docs code will be tested and QAed on these versions.

Version 5.25.1ļƒ

Date:

October 11, 2021

Version 5.25.0ļƒ

Date:

October 05, 2021

Version 5.24.0ļƒ

Date:

September 28, 2021

Version 5.23.6ļƒ

Date:

September 20, 2021

Version 5.23.5ļƒ

Date:

September 14, 2021

  • @humitos: Organization: only mark artifacts cleaned as False if they are True (#8481)

  • @astrojuanlu: Fix link to version states documentation (#8475)

  • @stsewd: OAuth models: increase avatar_url lenght (#8472)

  • @pzhlkj6612: Docs: update the links to the dependency management content of setuptools docs (#8470)

  • @stsewd: Permissions: avoid using project.users, use proper permissions instead (#8458)

  • @humitos: Docker build images: update design doc (#8447)

  • @astrojuanlu: New Read the Docs tutorial, part I (#8428)

Version 5.23.4ļƒ

Date:

September 07, 2021

  • @pzhlkj6612: Docs: update the links to the dependency management content of setuptools docs (#8470)

  • @nienn: Add custom team img styling (#8467)

  • @nienn: Docs: Change ā€œright-clickā€ to ā€œclickā€ (#8465)

  • @stsewd: Permissions: avoid using project.users, use proper permissions instead (#8458)

  • @stsewd: Add templatetag to filter by admin projects (#8456)

  • @stsewd: Support form: donā€™t allow to change the email (#8455)

  • @stsewd: Search: show only results from the current role_name being filtered (#8454)

  • @pyup-bot: pyup: Scheduled weekly dependency update for week 35 (#8451)

  • @stsewd: Update common (#8449)

  • @stsewd: API v3 (subprojects): filter by correct owner/organization (#8446)

  • @astrojuanlu: Rework Team page (#8441)

  • @mforbes: Added note about how to use Anaconda Project. (#8436)

  • @stsewd: Contact users: pass user and domain in the context (#8430)

  • @astrojuanlu: New Read the Docs tutorial, part I (#8428)

  • @stsewd: Footer: remove auth block (#8397)

  • @stsewd: API: fix subprojects creation when organizaions are enabled (#8393)

  • @stsewd: QuerySets: remove unused overrides (#8299)

  • @stsewd: QuerySets: filter permissions by organizations (#8298)

Version 5.23.3ļƒ

Date:

August 30, 2021

Version 5.23.2ļƒ

Date:

August 24, 2021

Version 5.23.1ļƒ

Date:

August 16, 2021

Version 5.23.0ļƒ

Date:

August 09, 2021

Version 5.22.0ļƒ

Date:

August 02, 2021

Version 5.21.0ļƒ

Date:

July 27, 2021

Version 5.20.3ļƒ

Date:

July 19, 2021

  • @Nkarnaud: change vieweable to viewable on home page: issue#8346 (#8351)

  • @stsewd: Builds: donā€™t record git rev-parse command (#8348)

  • @stsewd: UI: allow to close notifications (#8345)

  • @stsewd: Use email from DEFAULT_FROM_EMAIL to contact users (#8344)

  • @stsewd: Downgrade taggit (#8342)

  • @stsewd: Dont mutate env vars outside the BuildEnv classes (#8340)

  • @stsewd: Guides: how to import a private project using an ssh key (#8336)

Version 5.20.2ļƒ

Date:

July 13, 2021

Version 5.20.1ļƒ

Date:

June 28, 2021

Version 5.20.0ļƒ

Date:

June 22, 2021

Version 5.19.0ļƒ

Warning

This release contains a security fix to our CSRF settings: https://github.com/readthedocs/readthedocs.org/security/advisories/GHSA-3v5m-qmm9-3c6c

Date:

June 15, 2021

Version 5.18.0ļƒ

Date:

June 08, 2021

Version 5.17.0ļƒ

Date:

May 24, 2021

Version 5.16.0ļƒ

Date:

May 18, 2021

  • @stsewd: QuerySets: check for .is_superuser instead of has_perm (#8181)

  • @humitos: Build: use is_active method to know if the build should be skipped (#8179)

  • @humitos: APIv2: disable listing endpoints (#8178)

  • @stsewd: Project: use IntegerField for remote_repository from project form. (#8176)

  • @stsewd: Docs: remove some lies from cross referencing guide (#8173)

  • @stsewd: Docs: add space to bash code (#8171)

  • @pyup-bot: pyup: Scheduled weekly dependency update for week 19 (#8170)

  • @stsewd: Querysets: include organizations in is_active check (#8163)

  • @stsewd: Querysets: remove private and for_project (#8158)

  • @davidfischer: Disable FLOC by introducing permissions policy header (#8145)

  • @stsewd: Build: allow to install packages with apt (#8065)

Version 5.15.0ļƒ

Date:

May 10, 2021

  • @stsewd: Ads: donā€™t load script if a project is marked as ad_free (#8164)

  • @stsewd: Querysets: include organizations in is_active check (#8163)

  • @stsewd: Querysets: simplify project querysets (#8154)

  • @pyup-bot: pyup: Scheduled weekly dependency update for week 18 (#8153)

  • @stsewd: Search: default to search on default version of subprojects (#8148)

  • @stsewd: Remove protected privacy level (#8146)

  • @stsewd: Embed: fix paths that start with / (#8139)

  • @humitos: Metrics: run metrics task every 30 minutes (#8138)

  • @humitos: web-celery: add logging for OOM debug on suspicious tasks (#8131)

  • @agjohnson: Fix a few style and grammar issues with SSO docs (#8109)

  • @stsewd: Embed: donā€™t fail while querying sections with bad id (#8084)

  • @stsewd: Design doc: allow to install packages using apt (#8060)

Version 5.14.3ļƒ

Date:

April 26, 2021

Version 5.14.2ļƒ

Date:

April 20, 2021

Version 5.14.1ļƒ

Date:

April 13, 2021

  • @stsewd: OAuth: protection against deleted objects (#8081)

  • @cocobennett: Add page and page_size to server side api documentation (#8080)

  • @stsewd: Version warning banner: inject on role=ā€mainā€ or main tag (#8079)

  • @stsewd: OAuth: avoid undefined var (#8078)

  • @stsewd: Conda: protect against None when appending core requirements (#8077)

  • @humitos: SSO: add small paragraph mentioning how to enable it on commercial (#8063)

  • @agjohnson: Add separate version create view and create view URL (#7595)

Version 5.14.0ļƒ

Date:

April 06, 2021

This release includes a security update which was done in a private branch PR. See our security changelog for more details.

  • @pyup-bot: pyup: Scheduled weekly dependency update for week 14 (#8071)

  • @astrojuanlu: Clarify ad-free conditions (#8064)

  • @humitos: SSO: add small paragraph mentioning how to enable it on commercial (#8063)

  • @stsewd: Build environment: allow to run commands with a custom user (#8058)

  • @humitos: Design document for new Docker images structure (#7566)

Version 5.13.0ļƒ

Date:

March 30, 2021

Version 5.12.2ļƒ

Date:

March 23, 2021

Version 5.12.1ļƒ

Date:

March 16, 2021

Version 5.12.0ļƒ

Date:

March 08, 2021

Version 5.11.0ļƒ

Date:

March 02, 2021

Version 5.10.0ļƒ

Date:

February 23, 2021

Version 5.9.0ļƒ

Date:

February 16, 2021

Last Friday we migrated our site from Azure to AWS (read the blog post). This is the first release into our new AWS infra.

Version 5.8.5ļƒ

Date:

January 18, 2021

  • @pyup-bot: pyup: Scheduled weekly dependency update for week 03 (#7840)

  • @humitos: Speed up concurrent builds by limited to 5 hours ago (#7839)

  • @humitos: Match Redis version with production (#7838)

  • @saadmk11: Add Option to Enable External Builds Through Project Update API (#7834)

  • @stsewd: Docs: mention the version warning is for sphinx only (#7832)

  • @stsewd: Tests: make PRODUCTION_DOMAIN explicit (#7831)

  • @stsewd: Docs: make it easy to copy/pasta examples (#7829)

  • @stsewd: PR preview: pass PR and build urls to sphinx context (#7828)

  • @agjohnson: Hide design docs from documentation (#7826)

  • @stsewd: Footer: add cache tags (#7821)

  • @humitos: Log Stripe Resource fallback creation in Sentry (#7820)

  • @humitos: Register MetricsTask to send metrics to AWS CloudWatch (#7817)

  • @saadmk11: Add management command to Sync RemoteRepositories and RemoteOrganizations (#7803)

  • @stsewd: Mkdocs: default to ā€œdocsā€ for docs_dir (#7766)

Version 5.8.4ļƒ

Date:

January 12, 2021

  • @pyup-bot: pyup: Scheduled weekly dependency update for week 02 (#7818)

  • @stsewd: List SYNC_VERSIONS_USING_A_TASK flag in the admin (#7802)

  • @ericholscher: Update build concurrency numbers for Business (#7794)

  • @stsewd: Sphinx: use html_baseurl for setting the canonical URL (#7540)

Version 5.8.3ļƒ

Date:

January 05, 2021

Version 5.8.2ļƒ

Date:

December 21, 2020

Version 5.8.1ļƒ

Date:

December 14, 2020

  • @humitos: Register ShutdownBuilder task (#7749)

  • @saadmk11: Use ā€œpath_with_namespaceā€ for GitLab RemoteRepository full_name Field (#7746)

  • @stsewd: Features: remove USE_NEW_PIP_RESOLVER (#7745)

  • @stsewd: Version sync: exclude external versions when deleting (#7742)

  • @stsewd: Search: limit number of sections and domains to 10K (#7741)

  • @stsewd: Traffic analytics: donā€™t pass context if the feature isnā€™t enabled (#7740)

  • @stsewd: Analytics: move page views to its own endpoint (#7739)

  • @stsewd: FeatureQuerySet: make check for date inclusive (#7737)

  • @stsewd: Typo: date -> data (#7736)

  • @saadmk11: Use remote_id and vcs_provider Instead of full_name to Get RemoteRepository (#7734)

  • @pyup-bot: pyup: Scheduled weekly dependency update for week 49 (#7730)

  • @saadmk11: Update parts of code that were using the old RemoteRepository model fields (#7728)

  • @stsewd: Builds: donā€™t delete them when a version is deleted (#7679)

  • @stsewd: Sync versions: create new versions in bulk (#7382)

  • @humitos: Use mamba under a feature flag to create conda environments (#6815)

Version 5.8.0ļƒ

Date:

December 08, 2020

Version 5.7.0ļƒ

Date:

December 01, 2020

Version 5.6.5ļƒ

Date:

November 23, 2020

Version 5.6.4ļƒ

Date:

November 16, 2020

Version 5.6.3ļƒ

Date:

November 10, 2020

  • @pyup-bot: pyup: Scheduled weekly dependency update for week 43 (#7602)

Version 5.6.2ļƒ

Date:

November 03, 2020

Version 5.6.1ļƒ

Date:

October 26, 2020

Version 5.6.0ļƒ

Date:

October 19, 2020

Version 5.5.3ļƒ

Date:

October 13, 2020

Version 5.5.2ļƒ

Date:

October 06, 2020

Version 5.5.1ļƒ

Date:

September 28, 2020

Version 5.5.0ļƒ

Date:

September 22, 2020

  • @stsewd: Donā€™t install pygments (#7490)

  • @humitos: Limit concurrency per-organization (#7489)

  • @pyup-bot: pyup: Scheduled weekly dependency update for week 37 (#7482)

  • @humitos: Use permissions (project and group) for RemoteRepository.admin on GitLab (#7479)

Version 5.4.3ļƒ

Date:

September 15, 2020

Version 5.4.2ļƒ

Date:

September 09, 2020

  • @humitos: Show ā€œConnected Servicesā€ form errors to the user (#7469)

  • @humitos: Allow to extend OrganizationTeamBasicForm from -corporate (#7467)

  • @pyup-bot: pyup: Scheduled weekly dependency update for week 36 (#7465)

  • @AvdN: correct invalid YAML (#7458)

  • @stsewd: Remote repository: filter by account before deleting (#7454)

  • @humitos: Truncate the beginning of the commandsā€™ output (#7449)

  • @davidfischer: Update links to advertising (#7443)

  • @stsewd: Revert ā€œDonā€™t retry on POSTā€ (#7442)

  • @stsewd: Organizations: move signals (#7441)

  • @stsewd: Organizations: move forms (#7438)

  • @humitos: Grab the correct name of RemoteOrganization to use in the query (#7430)

  • @stsewd: Revert ā€œES: update dependenciesā€ (#7429)

  • @pyup-bot: pyup: Scheduled weekly dependency update for week 35 (#7423)

  • @humitos: Mark a build as DUPLICATED (same version) only itā€™s close in time (#7420)

Version 5.4.1ļƒ

Date:

September 01, 2020

Version 5.4.0ļƒ

Date:

August 25, 2020

Version 5.3.0ļƒ

Date:

August 18, 2020

Version 5.2.3ļƒ

Date:

August 04, 2020

Version 5.2.2ļƒ

Date:

July 29, 2020

Version 5.2.1ļƒ

Date:

July 14, 2020

Version 5.2.0ļƒ

Date:

July 07, 2020

Version 5.1.5ļƒ

Date:

July 01, 2020

Version 5.1.4ļƒ

Date:

June 23, 2020

Version 5.1.3ļƒ

Date:

June 16, 2020

Version 5.1.2ļƒ

Date:

June 09, 2020

Version 5.1.1ļƒ

Date:

May 26, 2020

Version 5.1.0ļƒ

Date:

May 19, 2020

This release includes one major new feature which is Pageview Analytics. This allows projects to see the pages in their docs that have been viewed in the past 30 days, giving them an idea of what pages to focus on when updating them.

This release also has a few small search improvements, doc updates, and other bugfixes as well.

Version 5.0.0ļƒ

Date:

May 12, 2020

This release includes two large changes, one that is breaking and requires a major version upgrade:

  • We have removed our deprecated doc serving code that used core/views, core/symlinks, and builds/syncers (#6535). All doc serving should now be done via proxito. In production this has been the case for over a month, we have now removed the deprecated code from the codebase.

  • We did a large documentation refactor that should make things nicer to read and highlights more of our existing features. This is the first of a series of new documentation additions we have planned

  • @ericholscher: Fix the caching of featured projects (#7054)

  • @ericholscher: Docs: Refactor and simplify our docs (#7052)

  • @stsewd: Mention using ssh URLs when using private submodules (#7046)

  • @ericholscher: Show project slug in Version admin (#7042)

  • @stsewd: List apiv3 first (#7041)

  • @stsewd: Remove CELERY_ROUTER flag (#7040)

  • @stsewd: Search: remove unused taxonomy field (#7033)

  • @agjohnson: Use a high time limit for celery build task (#7029)

  • @ericholscher: Clean up build admin to make list display match search (#7028)

  • @stsewd: Task Router: check for None (#7027)

  • @stsewd: Implement repo_exists for all VCS backends (#7025)

  • @stsewd: Mkdocs: Index pages without anchors (#7024)

  • @agjohnson: Move docker limits back to setting (#7023)

  • @humitos: Fix typo (#7022)

  • @stsewd: Fix linter (#7021)

  • @ericholscher: Release 4.1.8 (#7020)

  • @ericholscher: Cleanup unresolver logging (#7019)

  • @stsewd: Document about next when using a secret link (#7015)

  • @stsewd: Remove unused field project.version_privacy_level (#7011)

  • @ericholscher: Add proxito headers to redirect responses (#7007)

  • @stsewd: Make hidden field not null (#6996)

  • @humitos: Show a list of packages installed on environment (#6992)

  • @eric-wieser: Ensure invoked Sphinx matches importable one (#6965)

  • @ericholscher: Add an unresolver similar to our resolver (#6944)

  • @KengoTODA: Replace ā€œPROJECTā€ with project object (#6878)

  • @humitos: Remove code replaced by El Proxito and stateless servers (#6535)

Version 4.1.8ļƒ

Date:

May 05, 2020

This release adds a few new features and bugfixes. The largest change is the addition of hidden versions, which allows docs to be built but not shown to users on the site. This will keep old links from breaking but not direct new users there.

Weā€™ve also expanded the CDN support to make sure weā€™re passing headers on 3xx and 4xx responses. This will allow us to expand the timeout on our CDN.

Weā€™ve also updated and added a good amount of documentation in this release, and weā€™re starting a larger refactor of our docs to help users understand the platform better.

Version 4.1.7ļƒ

Date:

April 28, 2020

As of this release, most documentation on Read the Docs Community is now behind Cloudflareā€™s CDN. It should be much faster for people further from US East. Please report any issues you experience with stale cached documentation (especially CSS/JS).

Another change in this release related to how custom domains are handled. Custom domains will now redirect HTTP -> HTTPS if the Domainā€™s ā€œHTTPSā€ flag is set. Also, the subdomain URL (eg. <project>.readthedocs.io/...) should redirect to the custom domain if the Domainā€™s ā€œcanonicalā€ flag is set. These flags are configurable in your project dashboard under Admin > Domains.

Many of the other changes related to improvements for our infrastructure to allow us to have autoscaling build and web servers. There were bug fixes for projects using versions tied to annotated git tags and custom user redirects will now send query parameters.

Version 4.1.6ļƒ

Date:

April 21, 2020

Version 4.1.5ļƒ

Date:

April 15, 2020

Version 4.1.4ļƒ

Date:

April 14, 2020

Version 4.1.3ļƒ

Date:

April 07, 2020

Version 4.1.2ļƒ

Date:

March 31, 2020

Version 4.1.1ļƒ

Date:

March 24, 2020

Version 4.1.0ļƒ

Date:

March 17, 2020

Version 4.0.3ļƒ

Date:

March 10, 2020

Version 4.0.2ļƒ

Date:

March 04, 2020

Version 4.0.1ļƒ

Date:

March 03, 2020

Version 4.0.0ļƒ

Date:

February 25, 2020

This release upgrades our codebase to run on Django 2.2. This is a breaking change, so we have released it as our 4th major version.

Version 3.12.0ļƒ

Date:

February 18, 2020

This version has two major changes:

Version 3.11.6ļƒ

Date:

February 04, 2020

Version 3.11.5ļƒ

Date:

January 29, 2020

Version 3.11.4ļƒ

Date:

January 28, 2020

Version 3.11.3ļƒ

Date:

January 21, 2020

Version 3.11.2ļƒ

Date:

January 08, 2020

Version 3.11.1ļƒ

Date:

December 18, 2019

Version 3.11.0ļƒ

Date:

December 03, 2019

Version 3.10.0ļƒ

Date:

November 19, 2019

Version 3.9.0ļƒ

Date:

November 12, 2019

Version 3.8.0ļƒ

Date:

October 09, 2019

Version 3.7.5ļƒ

Date:

September 26, 2019

Version 3.7.4ļƒ

Date:

September 05, 2019

Version 3.7.3ļƒ

Date:

August 27, 2019

Version 3.7.2ļƒ

Date:

August 08, 2019

Version 3.7.1ļƒ

Date:

August 07, 2019

Version 3.7.0ļƒ

Date:

July 23, 2019

Version 3.6.1ļƒ

Date:

July 17, 2019

Version 3.6.0ļƒ

Date:

July 16, 2019

Version 3.5.3ļƒ

Date:

June 19, 2019

Version 3.5.2ļƒ

This is a quick hotfix to the previous version.

Date:

June 11, 2019

Version 3.5.1ļƒ

This version contained a security fix for an open redirect issue. The problem has been fixed and deployed on readthedocs.org. For users who depend on the Read the Docs code line for a private instance of Read the Docs, you are encouraged to update to 3.5.1 as soon as possible.

Date:

June 11, 2019

Version 3.5.0ļƒ

Date:

May 30, 2019

Version 3.4.2ļƒ

Date:

April 22, 2019

Version 3.4.1ļƒ

Date:

April 03, 2019

Version 3.4.0ļƒ

Date:

March 18, 2019

Version 3.3.1ļƒ

Date:

February 28, 2019

Version 3.3.0ļƒ

Date:

February 27, 2019

Version 3.2.3ļƒ

Date:

February 19, 2019

Version 3.2.2ļƒ

Date:

February 13, 2019

Version 3.2.1ļƒ

Date:

February 07, 2019

Version 3.2.0ļƒ

Date:

February 06, 2019

Version 3.1.0ļƒ

This version greatly improves our search capabilities, thanks to the Google Summer of Code. Weā€™re hoping to have another version of search coming soon after this, but this is a large upgrade moving to the latest Elastic Search.

Date:

January 24, 2019

Version 3.0.0ļƒ

Read the Docs now only supports Python 3.6+. This is for people running the software on their own servers, builds continue to work across all supported Python versions.

Date:

January 23, 2019

Version 2.8.5ļƒ

Date:

January 15, 2019

Version 2.8.4ļƒ

Date:

December 17, 2018

Version 2.8.3ļƒ

Date:

December 05, 2018

Version 2.8.2ļƒ

Date:

November 28, 2018

Version 2.8.1ļƒ

Date:

November 06, 2018

Version 2.8.0ļƒ

Date:

October 30, 2018

Major change is an upgrade to Django 1.11.

Version 2.7.2ļƒ

Date:

October 23, 2018

Version 2.7.1ļƒ

Date:

October 04, 2018

Version 2.7.0ļƒ

Date:

September 29, 2018

Reverted, do not use

Version 2.6.6ļƒ

Date:

September 25, 2018

Version 2.6.5ļƒ

Date:

August 29, 2018

Version 2.6.4ļƒ

Date:

August 29, 2018

Version 2.6.3ļƒ

Date:

August 18, 2018

Release to Azure!

Version 2.6.2ļƒ

Date:

August 14, 2018

Version 2.6.1ļƒ

Date:

July 17, 2018

Version 2.6.0ļƒ

Date:

July 16, 2018

Version 2.5.3ļƒ

Date:

July 05, 2018

Version 2.5.2ļƒ

Date:

June 18, 2018

Version 2.5.1ļƒ

Date:

June 14, 2018

Version 2.5.0ļƒ

Date:

June 06, 2018

Version 2.4.0ļƒ

Date:

May 31, 2018

Version 2.3.14ļƒ

Date:

May 30, 2018

Version 2.3.13ļƒ

Date:

May 23, 2018

Version 2.3.12ļƒ

Date:

May 21, 2018

Version 2.3.11ļƒ

Date:

May 01, 2018

Version 2.3.10ļƒ

Date:

April 24, 2018

Version 2.3.9ļƒ

Date:

April 20, 2018

Version 2.3.8ļƒ

Date:

April 20, 2018

  • @agjohnson: Give TaskStep class knowledge of the underlying task (#3983)

  • @humitos: Resolve domain when a project is a translation of itself (#3981)

Version 2.3.7ļƒ

Date:

April 19, 2018

Version 2.3.6ļƒ

Date:

April 05, 2018

Version 2.3.5ļƒ

Date:

April 05, 2018

Version 2.3.4ļƒ

  • Release for static assets

Version 2.3.3ļƒ

Version 2.3.2ļƒ

This version adds a hotfix branch that adds model validation to the repository URL to ensure strange URL patterns canā€™t be used.

Version 2.3.1ļƒ

Version 2.3.0ļƒ

Warning

Version 2.3.0 includes a security fix for project translations. See Release 2.3.0 for more information

Version 2.2.1ļƒ

Version 2.2.1 is a bug fix release for the several issues found in production during the 2.2.0 release.

Version 2.2.0ļƒ

Version 2.1.6ļƒ

Version 2.1.5ļƒ

Version 2.1.4ļƒ

Version 2.1.3ļƒ

date:

Dec 21, 2017

Version 2.1.2ļƒ

Version 2.1.1ļƒ

Release information missing

Version 2.1.0ļƒ

Version 2.0ļƒ

Previous releasesļƒ

Starting with version 2.0, we will be incrementing the Read the Docs version based on semantic versioning principles, and will be automating the update of our changelog.

Below are some historical changes from when we have tried to add information here in the past

July 23, 2015ļƒ

  • Django 1.8 Support Merged

Code notesļƒ

  • Updated Django from 1.6.11 to 1.8.3.

  • Removed South and ported the South migrations to Djangoā€™s migration framework.

  • Updated django-celery from 3.0.23 to 3.1.26 as django-celery 3.0.x does not support Django 1.8.

  • Updated Celery from 3.0.24 to 3.1.18 because we had to update django-celery. We need to test this extensively and might need to think about using the new Celery API directly and dropping django-celery. See release notes: https://docs.celeryproject.org/en/3.1/whatsnew-3.1.html

  • Updated tastypie from 0.11.1 to current master (commit 1e1aff3dd4dcd21669e9c68bd7681253b286b856) as 0.11.x is not compatible with Django 1.8. No surprises expected but we should ask for a proper release, see release notes: https://github.com/django-tastypie/django-tastypie/blob/master/docs/release_notes/v0.12.0.rst

  • Updated django-oauth from 0.16.1 to 0.21.0. No surprises expected, see release notes in the docs and finer grained in the repo

  • Updated django-guardian from 1.2.0 to 1.3.0 to gain Django 1.8 support. No surprises expected, see release notes: https://github.com/lukaszb/django-guardian/blob/devel/CHANGES

  • Using django-formtools instead of removed django.contrib.formtools now. Based on the Django release notes, these modules are the same except of the package name.

  • Updated pytest-django from 2.6.2 to 2.8.0. No tests required, but running the testsuite :smile:

  • Updated psycopg2 from 2.4 to 2.4.6 as 2.4.5 is required by Django 1.8. No trouble expected as Django is the layer between us and psycopg2. Also itā€™s only a minor version upgrade. Release notes: http://initd.org/psycopg/docs/news.html#what-s-new-in-psycopg-2-4-6

  • Added django.setup() to conf.py to load django properly for doc builds.

  • Added migrations for all apps with models in the readthedocs/ directory

Deployment notesļƒ

After you have updated the code and installed the new dependencies, you need to run these commands on the server:

python manage.py migrate contenttypes
python manage.py migrate projects 0002 --fake
python manage.py migrate --fake-initial

Locally I had trouble in a test environment that pip did not update to the specified commit of tastypie. It might be required to use pip install -U -r requirements/deploy.txt during deployment.

Development update notesļƒ

The readthedocs developers need to execute these commands when switching to this branch (or when this got merged into main):

  • Before updating please make sure that all migrations are applied:

    python manage.py syncdb
    python manage.py migrate
    
  • Update the codebase: git pull

  • You need to update the requirements with pip install -r requirements.txt

  • Now you need to fake the initial migrations:

    python manage.py migrate contenttypes
    python manage.py migrate projects 0002 --fake
    python manage.py migrate --fake-initial