summaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
-rw-r--r--README.md54
-rw-r--r--README.rst71
2 files changed, 71 insertions, 54 deletions
diff --git a/README.md b/README.md
deleted file mode 100644
index 877664f3..00000000
--- a/README.md
+++ /dev/null
@@ -1,54 +0,0 @@
-.. This work is licensed under a Creative Commons Attribution 4.0 International License.
-.. http://creativecommons.org/licenses/by/4.0
-.. (c) 2017 Enea AB and others
-
-Armband Fuel@OPNFV
-==================
-
-This repository holds build scripts for MCP Fuel OPNFV installer
-for AArch64 machines.
-
-Workflow
---------
-The standard workflow should look as follows:
-
-1. Clone the repository.
-
-2. All the sub-projects are registered as submodules. To initialize them, call:
- $ make submodules-init
-
-3. Apply patches from `patches/<sub-project>/*` to respective submodules via:
- $ make patches-import
-
- This will result in creation of:
- - a tag called `${A_OPNFV_TAG}-root` at submodule remote branch HEAD;
- - a new branch `opnfv-armband` which will hold all the armband work.
- Then each patch is applied on this new branch with `git-am`.
- The new HEAD is tagged with `${A_OPNFV_TAG}`.
-
-4. Modify sub-projects for whatever you need.
- Commit your changes when you want them taken into account in the build.
-
- NOTE: If you want to re-export patches, make sure to move the tag
- `${A_OPNFV_TAG}` to the latest commit that should be included.
-
-5. (not implemented yet for MCP) Build with:
- $ make build
-
-6. Re-create patches via:
- $ make patches-export
-
- Each commit on `opnfv-armband` branch of each subproject will be
- exported to `patches/subproject/` via `git format-patch`.
-
-7. Clean workbench branches and tags with:
- $ make submodules-clean
-
-Sub-projects
-------------
-If you need to add another subproject, you can do it with `git submodule`.
-Make sure that you specify branch (with `-b`), short name (with `--name`)
-and point it to `upstream/*` directory, i.e.:
-
- $ git submodule -b stable/mitaka add --name fuel-web \
- https://github.com/openstack/fuel-web.git upstream/fuel-web
diff --git a/README.rst b/README.rst
new file mode 100644
index 00000000..ba27cad6
--- /dev/null
+++ b/README.rst
@@ -0,0 +1,71 @@
+.. This work is licensed under a Creative Commons Attribution 4.0 International License.
+.. http://creativecommons.org/licenses/by/4.0
+.. (c) 2017 Enea AB and others
+
+Armband Fuel@OPNFV
+==================
+
+This repository holds build scripts for MCP Fuel OPNFV installer
+for AArch64 machines.
+
+Development Workflow
+====================
+
+The standard workflow should look as follows:
+
+#. Clone the repository.
+
+#. All the sub-projects are registered as submodules. To initialize them, call:
+
+ .. code-block:: bash
+
+ $ make submodules-init
+
+#. Apply patches from ``patches/<sub-project>/*`` to respective submodules via:
+
+ .. code-block:: bash
+
+ $ make patches-import
+
+ This will result in creation of:
+
+ - a tag called ``${A_OPNFV_TAG}-root`` at submodule remote branch HEAD;
+ - a new branch ``opnfv-armband`` which will hold all the armband work.
+
+ Then each patch is applied on this new branch with ``git-am``.
+
+ The new HEAD is tagged with ``${A_OPNFV_TAG}``.
+
+#. Modify sub-projects for whatever you need.
+
+ Commit your changes when you want them taken into account in the build.
+
+ *NOTE*: If you want to re-export patches, make sure to move the tag
+ ``${A_OPNFV_TAG}`` to the latest commit that should be included.
+
+#. Re-create patches and add default copyright header via:
+
+ .. code-block:: bash
+
+ $ make patches-export patches-copyright
+
+ Each commit on ``opnfv-armband`` branch of each subproject will be
+ exported to ``patches/subproject/`` via ``git format-patch``.
+
+#. Clean workbench branches and tags with:
+
+ .. code-block:: bash
+
+ $ make submodules-clean
+
+Sub-projects
+============
+
+If you need to add another subproject, you can do it with ``git submodule``.
+Make sure that you specify branch (with ``-b``), short name (with ``--name``)
+and point it to ``upstream/*`` directory, i.e.:
+
+ .. code-block:: bash
+
+ $ git submodule -b stable/mitaka add --name fuel-web \
+ https://github.com/openstack/fuel-web.git upstream/fuel-web