aboutsummaryrefslogtreecommitdiffhomepage
path: root/markup/pod/live-manual/media/text/en/project_contributing.ssi
diff options
context:
space:
mode:
authorRalph Amissah <ralph.amissah@gmail.com>2021-11-27 21:54:49 -0500
committerRalph Amissah <ralph.amissah@gmail.com>2021-11-27 21:54:49 -0500
commit78b1b83be0cf04b4cba707751b7ad4d97787fe37 (patch)
tree0260daae62c3c0c055b7ec73b274fa82b31b344f /markup/pod/live-manual/media/text/en/project_contributing.ssi
track document samples used
Diffstat (limited to 'markup/pod/live-manual/media/text/en/project_contributing.ssi')
-rw-r--r--markup/pod/live-manual/media/text/en/project_contributing.ssi90
1 files changed, 90 insertions, 0 deletions
diff --git a/markup/pod/live-manual/media/text/en/project_contributing.ssi b/markup/pod/live-manual/media/text/en/project_contributing.ssi
new file mode 100644
index 0000000..1352b1b
--- /dev/null
+++ b/markup/pod/live-manual/media/text/en/project_contributing.ssi
@@ -0,0 +1,90 @@
+:B~ Contributing to the project
+
+1~contributing-to-project Contributing to the project
+
+When submitting a contribution, please clearly identify its copyright holder and include any applicable licensing statement. Note that to be accepted, the contribution must be licensed under the same license as the rest of the documents, namely, GPL version 3 or later.
+
+Contributions to the project, such as translations and patches, are greatly welcome. Anyone can directly commit to the repositories, however, we ask you to send bigger changes to the mailing list to discuss them first. See the section {Contact}#contact for more information.
+
+The ${project} uses Git as version control system and source code management. As explained in {Git repositories}#git-repositories there are two main development branches: *{debian}* and *{debian-next}*. Everybody can commit to the debian-next branches of the live-boot, live-build, live-config, live-images, live-manual and live-tools repositories.
+
+However, there are certain restrictions. The server will reject:
+
+_* Non fast-forward pushes.
+
+_* Merge commits.
+
+_* Adding or removing tags or branches.
+
+Even though all commits might be revised, we ask you to use your common sense and make good commits with good commit messages.
+
+_* Write commit messages that consist of complete, meaningful sentences in English, starting with a capital letter and ending with a full stop. Usually, these will start with the form "Fixing/Adding/Removing/Correcting/Translating/...".
+
+_* Write good commit messages. The first line must be an accurate summary of the contents of the commit which will be included in the changelog. If you need to make some further explanations, write them below leaving a blank line after the first one and then another blank line after each paragraph. Lines of paragraphs should not exceed 80 characters in length.
+
+_* Commit atomically, this is to say, do not mix unrelated things in the same commit. Make one different commit for each change you make.
+
+2~ Making changes
+
+In order to push to the repositories, you must follow the following procedure. Here we use live-manual as an example so replace it with the name of the repository you want to work with. For detailed information on how to edit live-manual see {Contributing to this document}#how-to-contribute.
+
+_* Fetch the public commit key:
+
+code{
+
+ $ mkdir -p ~/.ssh/keys
+ $ wget http://live-systems.org/other/keys/git@live-systems.org -O ~/.ssh/keys/git@live-systems.org
+ $ wget http://live-systems.org/other/keys/git@live-systems.org.pub -O ~/.ssh/keys/git@live-systems.org.pub
+ $ chmod 0600 ~/.ssh/keys/git@live-systems.org*
+
+}code
+
+_* Add the following section to your openssh-client config:
+
+code{
+
+ $ cat >> ~/.ssh/config << EOF
+ Host live-systems.org
+ Hostname live-systems.org
+ User git
+ IdentitiesOnly yes
+ IdentityFile ~/.ssh/keys/git@live-systems.org
+ EOF
+
+}code
+
+_* Check out a clone of live-manual through ssh:
+
+code{
+
+ $ git clone git@live-systems.org:/live-manual.git
+ $ cd live-manual && git checkout debian-next
+
+}code
+
+_* Make sure you have Git author and email set:
+
+code{
+
+ $ git config user.name "John Doe"
+ $ git config user.email john@example.org
+
+}code
+
+*{Important:}* Remember that you should commit any changes on the *{debian-next}* branch.
+
+_* Make your changes. In this example you would first write a new section dealing with applying patches and then prepare to commit adding the files and writing your commit message like this:
+
+code{
+
+ $ git commit -a -m "Adding a section on applying patches."
+
+}code
+
+_* Push the commit to the server:
+
+code{
+
+ $ git push
+
+}code