<commit_before># FreshRSS documentation

The documentation has not been translated in English for yet. Here are some indication how to contribute.

## How-to contribute?

At the moment, FreshRSS documentation is far from being complete. We need all the help we can get to fill the blanks. If you are willing to contribute, this document provides basic directions to do it. If you want to know how documentation is generated on [doc.freshrss.org](http://doc.freshrss.org), please refer to the "How does it work?" section.

1. [Fork the Github project](https://github.com/FreshRSS/documentation).
2. Pull your fork on your computer or modify it directly on Github.
3. The English documentation is located in the ```./en``` folder.
4. The documentation use Markdown syntax. This syntax is pretty straightforward. If you need some guidance, read the [Github guide to Markdown](https://guides.github.com/features/mastering-markdown/).
5. Make a "pull request" on the official repository.
6. You are done! Your changes will go through a team review then merged. Then, we will update [doc.freshrss.org](http://doc.freshrss.org).

## Translate the documentation.

At the moment, the documentation is available in French for practical reasons. We are looking for people willing to translate it to English (or other languages). Please contact us on Github if you want to contribute. The process is identical to the later process except you will need to write the documentation in its own language folder, ```./en``` for English, ```./es``` for Spanish, etc.

## How does it work?

FreshRSS documentation is generated by [MkDocs](http://www.mkdocs.org/). It is a Python software which generates static sites designed for documentation.

This repository contains only raw content in Markdown, images and configuration files (one per language).

To generate the documentation website, you have to follow some few steps. First, make sure Python 2.7+ and `pip` are installed on your PC. Working in a virtual environment is better (`virtualenv`, `pew` or similar).

```bash
$ pip install mkdocs  # Install MkDocs software
$ cd ./en             # Move to the English language directory
$ mkdocs serve        # Have a preview at http://127.0.0.1:8000
$ # Build the website and push files onto your server
$ mkdocs build --clean
$ rsync -e ssh -P -rvzc --delete ./site/ user@server:/path/to/server/root/en
```

The `index.html` file is used to handle the home page and to support internationalised documentation since MkDocs doesn't support it yet.

We use a custom version of readthedocs theme which include the fonts directly (i.e. instead of using Google servers). Tu use it, you have to copy/paste the theme directory in the language folders.

```bash
$ cd ./en
$ cp -R ../readthedocs ./
$ # OR with a symbolic link
$ ln -s ../readthedocs ./
```
<commit_msg>Change main page of english documentation<commit_after>![FreshRSS logo](img/logo_freshrss.png)

FreshRSS is a RSS aggregator and reader. It gives you possibility to read and follow several news website at a glance without the need to go from a website to another.

FreshRSS has a lot of features including:

- RSS and Atom aggregation
- Mark article as favorite if you liked it or if you want to read it later
- Filter and search functionalities are working together to find easily articles
- Statistics help you to know the frequency of publishing of all the websites you are following
- Import/export of your feeds into OPML format
- Several themes created by the community
- "Google Reader"-like API to connect Android applications
- The application is "responsive" which means it adapts to small screens so you can bring articles in your pocket
- Self-hosted: code is free (under AGPL3 licence) and so you can host your own instance of FreshRSS
- Multi-users so you can host your friends and your family
- And a lot more!

This documentation is splitted in two sections:

- [users documentation](users/02_First_steps.md) so you can discover all the power of FreshRSS
- [developers documentation](developers/01_First_steps.md) to guide you in the source code of FreshRSS and to help you if you want to contribute

{'fraction_non_alphanumeric': 0.06924741524404905, 'fraction_numerical': 0.005530175522962251, 'mean_word_length': 4.08557457212714, 'pattern_counts': {'":': 0, '<': 3, '<?xml version=': 0, '>': 3, 'https://': 2, 'lorem ipsum': 0, 'www.': 1, 'xml': 0}, 'pii_count': 1, 'substrings_counts': 0, 'word_list_counts': {'cursed_substrings.json': 0, 'profanity_word_list.json': 0, 'sexual_word_list.json': 0, 'zh_pornsignals.json': 0}}
{'dir': 'git-commits-cleaned', 'id': '4378889', 'n_tokens_mistral': 1104, 'n_tokens_neox': 1046, 'n_words': 605}