Merge tag '3.9.0' into relcorp

Author: agjohnson

.gitignore

@@ -37,7 +37,6 @@ media/pdf
 media/static
 /static
 node_modules
-package-lock.json
 readthedocs/rtd_tests/builds
 readthedocs/rtd_tests/tests/builds
 user_builds

.travis.yml

@@ -2,6 +2,11 @@ language: python
 python:
   - 3.6
 dist: xenial
+
+env:
+  global:
+    - NODE_VERSION=10.17.0
+
 matrix:
   include:
     - python: 3.6
@@ -27,8 +32,8 @@ install:
   - pip install tox-travis
   - curl -o- https://raw.githubusercontent.com/creationix/nvm/v0.33.2/install.sh | bash
   - source ~/.nvm/nvm.sh
-  - nvm install --lts
-  - nvm use --lts
+  - nvm install $NODE_VERSION
+  - nvm use $NODE_VERSION
   - npm install -g bower
   - npm install
   - bower install

CHANGELOG.rst

@@ -1,3 +1,58 @@
+Version 3.9.0
+-------------
+
+:Date: November 12, 2019
+
+* `@davidfischer <http://github.com/davidfischer>`__: Pin the node dependencies with a package-lock (`#6370 <https://github.com/readthedocs/readthedocs.org/pull/6370>`__)
+* `@humitos <http://github.com/humitos>`__: Force PUBLIC_DOMAIN_USES_HTTPS on version compare tests (`#6367 <https://github.com/readthedocs/readthedocs.org/pull/6367>`__)
+* `@segevfiner <http://github.com/segevfiner>`__: Remove a stray backtick from import-guide.rst (`#6362 <https://github.com/readthedocs/readthedocs.org/pull/6362>`__)
+* `@stsewd <http://github.com/stsewd>`__: Don't compare inactive or non build versions (`#6361 <https://github.com/readthedocs/readthedocs.org/pull/6361>`__)
+* `@stsewd <http://github.com/stsewd>`__: Fix test (`#6358 <https://github.com/readthedocs/readthedocs.org/pull/6358>`__)
+* `@ericholscher <http://github.com/ericholscher>`__: Change the default of proxied_api_host to api_host (`#6355 <https://github.com/readthedocs/readthedocs.org/pull/6355>`__)
+* `@stsewd <http://github.com/stsewd>`__: Dont link to dashboard from footer (`#6353 <https://github.com/readthedocs/readthedocs.org/pull/6353>`__)
+* `@humitos <http://github.com/humitos>`__: Upgrade django-storages (`#6339 <https://github.com/readthedocs/readthedocs.org/pull/6339>`__)
+* `@pyup-bot <http://github.com/pyup-bot>`__: pyup:  Scheduled weekly dependency update for week 43 (`#6334 <https://github.com/readthedocs/readthedocs.org/pull/6334>`__)
+* `@KartikKapil <http://github.com/KartikKapil>`__: added previous year gsoc projects (`#6333 <https://github.com/readthedocs/readthedocs.org/pull/6333>`__)
+* `@stsewd <http://github.com/stsewd>`__: Support 6.0rc1 build image (`#6329 <https://github.com/readthedocs/readthedocs.org/pull/6329>`__)
+* `@stsewd <http://github.com/stsewd>`__: Don't error on non existing version (`#6325 <https://github.com/readthedocs/readthedocs.org/pull/6325>`__)
+* `@stsewd <http://github.com/stsewd>`__: Remove files from storage and delete indexes from ES when no longer needed (`#6323 <https://github.com/readthedocs/readthedocs.org/pull/6323>`__)
+* `@stsewd <http://github.com/stsewd>`__: Fix eslint (`#6317 <https://github.com/readthedocs/readthedocs.org/pull/6317>`__)
+* `@humitos <http://github.com/humitos>`__: Revert "Adding RTD prefix for docker only in setting.py and all… (`#6315 <https://github.com/readthedocs/readthedocs.org/pull/6315>`__)
+* `@anindyamanna <http://github.com/anindyamanna>`__: Fixed Broken links (`#6300 <https://github.com/readthedocs/readthedocs.org/pull/6300>`__)
+* `@stsewd <http://github.com/stsewd>`__: Use sync instead of copy for blob storage (`#6298 <https://github.com/readthedocs/readthedocs.org/pull/6298>`__)
+* `@sciencewhiz <http://github.com/sciencewhiz>`__: Fix missing word in wipe guide (`#6294 <https://github.com/readthedocs/readthedocs.org/pull/6294>`__)
+* `@jaferkhan <http://github.com/jaferkhan>`__: Removed unused code from view and template (#6250) (`#6288 <https://github.com/readthedocs/readthedocs.org/pull/6288>`__)
+* `@stsewd <http://github.com/stsewd>`__: Rename test name (`#6283 <https://github.com/readthedocs/readthedocs.org/pull/6283>`__)
+* `@davidfischer <http://github.com/davidfischer>`__: Store version media availability (`#6278 <https://github.com/readthedocs/readthedocs.org/pull/6278>`__)
+* `@davidfischer <http://github.com/davidfischer>`__: Link to the terms of service (`#6277 <https://github.com/readthedocs/readthedocs.org/pull/6277>`__)
+* `@saadmk11 <http://github.com/saadmk11>`__: API V3 Subproject Creation Bug fix (`#6275 <https://github.com/readthedocs/readthedocs.org/pull/6275>`__)
+* `@stsewd <http://github.com/stsewd>`__: Fix footer (`#6274 <https://github.com/readthedocs/readthedocs.org/pull/6274>`__)
+* `@stsewd <http://github.com/stsewd>`__: Fix tests (`#6269 <https://github.com/readthedocs/readthedocs.org/pull/6269>`__)
+* `@stsewd <http://github.com/stsewd>`__: Refactor profile's views (`#6267 <https://github.com/readthedocs/readthedocs.org/pull/6267>`__)
+* `@humitos <http://github.com/humitos>`__: Default to None when using the Serializer as Form for Browsable… (`#6266 <https://github.com/readthedocs/readthedocs.org/pull/6266>`__)
+* `@ericholscher <http://github.com/ericholscher>`__: Fix inactive version list not showing when no resuts returned (`#6264 <https://github.com/readthedocs/readthedocs.org/pull/6264>`__)
+* `@ericholscher <http://github.com/ericholscher>`__: Downgrade django-storges. (`#6263 <https://github.com/readthedocs/readthedocs.org/pull/6263>`__)
+* `@ericholscher <http://github.com/ericholscher>`__: Release 3.8.0 (`#6262 <https://github.com/readthedocs/readthedocs.org/pull/6262>`__)
+* `@stsewd <http://github.com/stsewd>`__: Update doccs version detail (api v3) (`#6259 <https://github.com/readthedocs/readthedocs.org/pull/6259>`__)
+* `@stsewd <http://github.com/stsewd>`__: Merge #6176 to master (`#6258 <https://github.com/readthedocs/readthedocs.org/pull/6258>`__)
+* `@humitos <http://github.com/humitos>`__: Remove privacy_level field from APIv3 (`#6257 <https://github.com/readthedocs/readthedocs.org/pull/6257>`__)
+* `@saadmk11 <http://github.com/saadmk11>`__: Redirect /projects/ URL to /dashboard/ (`#6255 <https://github.com/readthedocs/readthedocs.org/pull/6255>`__)
+* `@davidfischer <http://github.com/davidfischer>`__: Allow project badges for private version (`#6252 <https://github.com/readthedocs/readthedocs.org/pull/6252>`__)
+* `@stsewd <http://github.com/stsewd>`__: Add pub_date to project admin (`#6244 <https://github.com/readthedocs/readthedocs.org/pull/6244>`__)
+* `@saadmk11 <http://github.com/saadmk11>`__: Allow only post requests for delete views (`#6242 <https://github.com/readthedocs/readthedocs.org/pull/6242>`__)
+* `@Iamshankhadeep <http://github.com/Iamshankhadeep>`__: Changing created to modified time (`#6234 <https://github.com/readthedocs/readthedocs.org/pull/6234>`__)
+* `@ericholscher <http://github.com/ericholscher>`__: Initial stub of proxito (`#6226 <https://github.com/readthedocs/readthedocs.org/pull/6226>`__)
+* `@saadmk11 <http://github.com/saadmk11>`__: Add Better error message for lists in config file (`#6200 <https://github.com/readthedocs/readthedocs.org/pull/6200>`__)
+* `@stsewd <http://github.com/stsewd>`__: Put view under login (`#6193 <https://github.com/readthedocs/readthedocs.org/pull/6193>`__)
+* `@humitos <http://github.com/humitos>`__: Ship API v3 (`#6169 <https://github.com/readthedocs/readthedocs.org/pull/6169>`__)
+* `@stsewd <http://github.com/stsewd>`__: Protection against ReDoS (`#6163 <https://github.com/readthedocs/readthedocs.org/pull/6163>`__)
+* `@dojutsu-user <http://github.com/dojutsu-user>`__: Optimize json parsing (`#6160 <https://github.com/readthedocs/readthedocs.org/pull/6160>`__)
+* `@tapaswenipathak <http://github.com/tapaswenipathak>`__: Added missing i18n for footer api (`#6144 <https://github.com/readthedocs/readthedocs.org/pull/6144>`__)
+* `@stsewd <http://github.com/stsewd>`__: Use different setting for footer api url (`#6131 <https://github.com/readthedocs/readthedocs.org/pull/6131>`__)
+* `@dojutsu-user <http://github.com/dojutsu-user>`__: Remove 'highlight' URL param from search results (`#6087 <https://github.com/readthedocs/readthedocs.org/pull/6087>`__)
+* `@Iamshankhadeep <http://github.com/Iamshankhadeep>`__: Adding RTD prefix for docker only in setting.py and all other places where is needed (`#6040 <https://github.com/readthedocs/readthedocs.org/pull/6040>`__)
+* `@stsewd <http://github.com/stsewd>`__: Design doc for organizations (`#5958 <https://github.com/readthedocs/readthedocs.org/pull/5958>`__)
+
 Version 3.8.0
 -------------
 

docs/api/index.rst

@@ -11,3 +11,4 @@ from Read the Docs.
     :maxdepth: 3
 
     v2
+    v3

docs/api/v2.rst

@@ -1,22 +1,22 @@
-API v2
-======
+API v2 (deprecated)
+===================
 
 The Read the Docs API uses :abbr:`REST (Representational State Transfer)`.
 JSON is returned by all API responses including errors
 and HTTP response status codes are to designate success and failure.
 
 .. note::
 
-    A newer API v3 is in early development stages.
+    A newer and better API v3 is ready to use.
     Some improvements coming in v3 are:
 
-    * Search API
-    * Write access
-    * Simpler URLs which use slugs instead of numeric IDs
+    * Simpler URLs which use slugs
+    * Token based authentication
+    * Import a new project
+    * Activate a version
     * Improved error reporting
 
-    If there are features you would like in v3, please get in touch
-    in the `issue tracker <https://github.com/readthedocs/readthedocs.org/issues>`_.
+    See its full documentation at :doc:`/api/v3`.
 
 
 Authentication and authorization