pip install to use poetry as the build backend

.gitignore

@@ -31,4 +31,7 @@ coverage.xml
 .coverage
 
 # Ignore tox installation
-.tox
+.tox
+
+# Docs generation
+docs.egg-info

.readthedocs.yml

@@ -1,7 +1,13 @@
 # https://docs.readthedocs.io/en/latest/config-file/index.html
 version: 2
+build:
+  image: latest
 python:
+  version: 3.7
   install:
-    - requirements: docs/requirement.txt
+    - method: pip
+      path: .
+      extra_requirements:
+        - docs
 mkdocs:
   configuration: mkdocs.yml

docs/common_tasks.md

@@ -7,7 +7,7 @@ that makes working on the docs locally much easier.
 
 ```console
 % pip install poetry
-% poetry install
+% poetry install --extras "docs"
 % poetry run mkdocs serve
 ```
 

pyproject.toml

@@ -1,16 +1,24 @@
+[build-system]
+requires = ["poetry>=1.0.5"]
+build-backend = "poetry.masonry.api"
+
 [tool.poetry]
-name = "docs-package"
+name = "docs"
 version = "1.0.0"
 description = "This is the package installer for docs"
 authors = ["Mozilla"]
 
 [tool.poetry.dependencies]
 python = "^3.7"
 
-[tool.poetry.dev-dependencies]
-mkdocs = "1.0.4"
-mkdocs-material = "==4.6.3"
-mdx_truly_sane_lists = "1.2"
+# A list of all of the optional dependencies, some of which are included in the
+# below `extras`. They can be opted into by apps.
+mkdocs = { version = "1.0.4", optional = true }
+mkdocs-material = { version = "4.6.3", optional = true }
+mdx_truly_sane_lists = { version = "1.2", optional = true }
+
+[tool.poetry.extras]
+docs = ["mkdocs", "mkdocs-material", "mdx_truly_sane_lists"]
 
 [tool.black]
 line-length = 100

tox.ini

@@ -29,11 +29,10 @@ commands_post =
 [testenv:docs]
 commands_pre =
     pip install poetry
-    poetry install
-    # Generate the requirements file for Readthedocs
-    poetry export -f requirements.txt -o docs/requirement.txt
+    poetry install --extras "docs"
 commands =
     mkdocs build
+commands_post =
 
 [testenv:docker]
 whitelist_externals=