diff options
author | 2017-10-18 21:11:40 +0200 | |
---|---|---|
committer | 2017-10-18 19:37:29 +0000 | |
commit | e459998934a11ddafb62a0b011448b1bf295f370 (patch) | |
tree | 0a861bf35df779e9b4e07725477c091bd6794e5a /README.rst | |
parent | b7637b1f61d60ac3e4edf80cac7150888ebccd70 (diff) |
README: Convert from markdown to RST
Change-Id: I80d3bea1a97382f778c33e5bae4226cca869179b
Signed-off-by: Alexandru Avadanii <Alexandru.Avadanii@enea.com>
(cherry picked from commit 46f224ce3ae56e96bd9b522a7c63b8817c132ca7)
Diffstat (limited to 'README.rst')
-rw-r--r-- | README.rst | 71 |
1 files changed, 71 insertions, 0 deletions
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 |