~~NOTRANS~~

====== Retrieve and create documentation ======

Here you will find some examples to checkout a documentation, and how to create a branch inside the repository for an application.

Downloading the //xfce4-docs// repository:
  git clone git://git.xfce.org/xfce/xfce4-docs
  git clone ssh://<USERNAME>@git.xfce.org/git/xfce/xfce4-docs

===== Checkout a documentation =====

Listing local branches:
  git branch

Listing local and remote branches:
  git branch -a

Checking out a branch for the first time:
  git checkout -b <NEW-BRANCH-NAME> --track <BRANCH>

Checking out a local branch:
  git checkout <BRANCH>

===== Create a new documentation =====

Creating a new and empty branch:
  git checkout --orphan <BRANCH>

Creating a new branch on top of a template:
  git checkout -b <NEW-BRANCH-NAME> --track template-guide
  git checkout -b <NEW-BRANCH-NAME> --track template-page

Adding new files:
  git add [files]
  git commit -m"Update documentation: section <FOO>"
  git push