Skip to content

Commit a74ec85

Browse files
committed
Expand the docs and fix typos
1 parent ddb6f19 commit a74ec85

File tree

1 file changed

+15
-4
lines changed

1 file changed

+15
-4
lines changed

docs/guides/build-using-too-many-resources.rst

Lines changed: 15 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -12,7 +12,7 @@ Reduce formats you're building
1212

1313
You can change the formats of docs that you're building with our YAML file's :ref:`yaml-config:Formats` option.
1414

15-
In particular, the `htmlzip` takes up a decent amount of memory and time,
15+
In particular, the ``htmlzip`` takes up a decent amount of memory and time,
1616
so disabling that format might solve your problem.
1717

1818
Reduce documentation build dependencies
@@ -27,8 +27,19 @@ as well as reduce your memory footprint.
2727
Use pip when possible
2828
---------------------
2929

30-
In case you are using `conda` to create your environment,
31-
you could consider using `pip` instead since `conda` could require too much memory to calculate the dependency tree.
30+
If you don't need ``conda`` to create your *documentation* environment,
31+
consider using ``pip`` instead since ``conda`` could `require too much memory`_ to calculate the dependency tree
32+
when using multiple channels.
33+
34+
.. _require too much memory: https://github.com/conda/conda/issues/5003>
35+
36+
37+
.. tip::
38+
39+
Even though your *project* environment is created with ``conda``, it may be not necessary for the *documentation* environment.
40+
That is, to build the documentation is probably that you need fewer Python packages than to use your library itself.
41+
So, in this case, you could use ``pip`` to install those fewer packages instead of creating a big environment with ``conda``.
42+
3243

3344
Use system site-packages for pre-installed libs
3445
-----------------------------------------------
@@ -37,6 +48,6 @@ There are a few libraries that Read the Docs has already installed (scipy, numpy
3748
in the Docker image used to build your docs. You can check the updated list of pre-installed libraries in the `Docker image repository`_.
3849

3950
To use these pre-installed libraries and avoid consuming time re-downloading/compiling them,
40-
you ca use the :ref:`yaml-config:Python-use-system-site-packages` option to have access to them.
51+
you can use the :ref:`yaml-config:python.use_system_site_packages` option to have access to them.
4152

4253
.. _Docker image repository: https://github.com/rtfd/readthedocs-docker-images

0 commit comments

Comments
 (0)