README.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/alice-doc/alice-analysis-tutorial
cd alice-analysis-tutorial/
git remote add <my_username> https://github.com/<my_username>/alice-analysis-tutorial

Documentation is written in Markdown. To preview the documentation pages locally while you are editing them, go in the root directory of the repository 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 <my_username>

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