# Process requirements

The process of creation XOOPS Documentation using **GitBook** and **GitHub** requires:

* Account on **GitHub** (<http://www.github.com>)
  * basic knowledge of using GitHub Website
  * basic understanding of using Git as Versioning system
  * basic knowledge of **Markdown**&#x20;
* Account on **GitBook** (<http://www.gitbook.com>)
  * to learn more about GitBook, please read [this publication](http://help.gitbook.io/)

## Creating a GitHub Repository for the book

There are two ways to contribute to XOOPS Documentation:

**a) Fork an existing book/tutorial**

To do so, go to an existing tutorial on [**GitHub XOOPS Docs**](https://github.com/XoopsDocs), and fork it by clicking on the Fork Button: ([screenshot](http://mrm-screen.s3.amazonaws.com/MrMaksimizegitbookstarterkit_20140707_085000_20140707_085006.png))

* Rename the repo to what you want your book to be called:
  * Click settings from the home screen of the forked repo (forking creates a copy of the repository under your username). ([screenshot](http://mrm-screen.s3.amazonaws.com/MrMaksimizegitbookstarterkit_20140707_100321_20140707_100325.png))
  * Rename the repo if needed ([screenshot](http://mrm-screen.s3.amazonaws.com/Options_20140707_100417_20140707_100421.png))
* Clone the repo to your machine, if you want to work on the document locally. For Windows users there is the [GitHub for Windows](https://windows.github.com/), which can be very helpful. You just need to click the "Clone" button on your repository, and GitHub will take care of the rest.

  Of course, you can also use your favorite way of interacting with Git, incl. the command line.

**b) Creating a new book/tutorial from scratch**

* You can also start writing a book/tutorial from scratch by creating a new repository in your account.&#x20;
* In this case, we recommend to use the "[**XOOPS Documentation Starter Kit**](https://github.com/XoopsDocs/gitbook-starterkit)", that has already a predefined projects structure and the required files, making it easier for you to just start writing. There is more information about it in the last chapter in this publication.
