docs: make docs build incremental 90/35790/5
authorNathan Skrzypczak <nathan.skrzypczak@gmail.com>
Fri, 25 Mar 2022 11:06:51 +0000 (12:06 +0100)
committerDave Wallace <dwallacelf@gmail.com>
Tue, 24 May 2022 20:58:36 +0000 (16:58 -0400)
commit1e167a4aadcf254cc8b755b3b45843604de58cb2
tree89ebf6ef02059cd2615956ab4b05834ebde39748
parent26c39878ad8c2e5e673956327badcd6e419488db
docs: make docs build incremental

This patch makes the `make docs` directive incremental
avoiding re-running the siphon when the source hasn't
changed, and leveraging sphinx internal cache.
It adds a `make rebuild-docs` directive for cases where
this caching logic might break, e.g. in CI.
The virtualenv doesn't also get recreated on each build,
which might be enough when writing docs, provided
automated process leverage its rebuild counterpart.

Type: improvement

Change-Id: Ie90de3adebeed017b249cad81c6c160719f71e8d
Signed-off-by: Nathan Skrzypczak <nathan.skrzypczak@gmail.com>
Signed-off-by: Dave Wallace <dwallacelf@gmail.com>
Makefile
docs/Makefile
docs/_scripts/Makefile
docs/_scripts/siphon-generate
docs/_scripts/siphon-process