From 5a979ff98773bbd4570b12e521173b881dd6da95 Mon Sep 17 00:00:00 2001 From: Markus Heiser Date: Sat, 26 Jun 2021 13:10:56 +0200 Subject: [PATCH] [docs] describe the usage of the static.build.* scripts Signed-off-by: Markus Heiser --- docs/dev/quickstart.rst | 23 ++++++++++++++++++++++- 1 file changed, 22 insertions(+), 1 deletion(-) diff --git a/docs/dev/quickstart.rst b/docs/dev/quickstart.rst index 74bb5296..8132bccc 100644 --- a/docs/dev/quickstart.rst +++ b/docs/dev/quickstart.rst @@ -29,7 +29,7 @@ If you implement themes, you will need to compile styles and JavaScript before .. code:: sh - make themes + make themes.all Don't forget to install npm_ first. @@ -53,3 +53,24 @@ Don't forget to install npm_ first. sudo -H dnf install npm +If you finished your *tests* you can start to commit your changes. To separate +the changed code from the build products first run: + +.. code:: sh + + make static.build.restore + +This will restore the old build products and only your changes of the code +remain in the working tree which can now be added & commited. When all sources +are commited, you can commit the build products simply by: + +.. code:: sh + + make static.build.commit + +Commiting the build products should be the last step, just before you send us +your PR. There is also a make target to rewind this last build commit: + +.. code:: sh + + make static.build.drop