CONTRIBUTING.md

Welcome to the ALICE Analysis Tutorial documentation

This is a community-contributed place where we collect all our documentation. Every ALICE member can contribute, and the Analysis Tutorial Committee will review every contribution.

Where can I see the documentation online?

Documentation is published on GitHub pages at the following address:

https://alice-doc.github.io/alice-analysis-tutorial/

How can I contribute to the documentation?

First off you need a GitHub account. Fork the alice-doc/alice-analysis-tutorial repository, then clone it to your laptop:

git clone https://github.com/<your-github-username>/alice-analysis-tutorial
cd alice-analysis-tutorial/
git remote add upstream https://github.com/alice-doc/alice-analysis-tutorial

Documentation is written in Markdown and it is generated using GitBook. You need to install GitBook first. GitBook is a NodeJS package, meaning that you need npm to install it. You can get npm easily.

On Ubuntu:

sudo apt install npm

On macOS (assuming you have Homebrew):

brew install npm

On CentOS 7 (you need EPEL enabled):

sudo yum install npm

Once npm is installed, you can install GitBook:

sudo npm install -g gitbook-cli@2.3.0

Do not use sudo on macOS.

Once GitBook is installed, you should find it in your $PATH, check it with:

type gitbook

To preview the documentation pages locally while you are editing them, move to the repository's root directory and run:

cd alice-analysis-tutorial/
make serve

The command will not exit and a local website will be visible at the following address:

http://localhost:4000

The website uses GitBook. Editing the pages using your favorite text editor: whenever you save, the page currently opened in your local preview will be refreshed automatically.

When you are happy with your modifications, commit them, push them to your repository and open a pull request, for instance:

git commit -a -m 'I am happy with my doc'
git push origin

then navigate to your GitHub repository online to open a pull request.