diff --git a/docs/source/index.rst b/docs/source/index.rst index 78e7af4152..a04e98a3bd 100755 --- a/docs/source/index.rst +++ b/docs/source/index.rst @@ -1,7 +1,11 @@ -Welcome to the Augur Documentation! +Augur Documentation ================================== -Welcome Augur's documentation is split into Seven parts,if you’re new to the project, we recommend giving it a once-over as a gentle introduction. Otherwise, feel free to hop right into the docs! +Welcome! +~~~~~~~~ +~~~~~~~~ + +Augur's documentation; (pronounced awe-grrr), is split into seven (7) parts. If you’re new to the project, we recommend giving it a once-over as a gentle introduction. Otherwise, feel free to hop right into the docs! .. toctree:: :maxdepth: 2 @@ -29,11 +33,15 @@ What is Augur? Augur is a software suite for collecting and measuring structured data about free and open-source software (FOSS) communities. -Augur’s main focus is to measure the overall health and sustainability of open source projects, as these types of projects are system critical for nearly every software organization or company. We do this by gathering data about project repositories and normalizing that into our data model to provide useful metrics about your project’s health. For example, one of our metrics is Burstiness. Burstiness – how are short timeframes of intense activity, followed by a corresponding return to a typical pattern of activity, observed in a project? This can paint a picture of a project’s focus and gain insight into the potential stability of a project and how its typical cycle of updates occurs. There are many more useful metrics, and you can find a full list of them here. +Augur’s main focus is to measure the overall health and sustainability of open source projects, as these types of projects are system critical for nearly every software organization or company. We do this by gathering data about project repositories and normalizing that into our data model to provide useful metrics about your project’s health. For example, one of our metrics is Burstiness. Burstiness – how are short timeframes of intense activity, followed by a corresponding return to a typical pattern of activity, observed in a project? This can paint a picture of a project’s focus and gain insight into the potential stability of a project and how its typical cycle of updates occurs. There are many more useful metrics, and you can find a full list of them `here `_. + + +Augur gathers trace data for a group of repositories, normalize it into our data model, and provide a variety of metrics about that data. + +This software is developed as part of the CHAOSS (Community Health Analytics Open Source Software) project. Many of our metrics are implementations of the metrics defined by our community. You can find more information about how to get involved on the CHAOSS website. -Augur gathers trace data for a group of repositories, normalize it inot our data model, and provide a variety of metrics about the said data. +If you want to see augur in action, you can view CHAOSS’s augur instance at http://augur.chaoss.io -This software is developed as part of the CHAOSS (Community Health Analytics Open Source Software) project. Many of our metrics are implementations of the metrics defined by our awesome community. You can find more information about how to get involved on the CHAOSS website. If you want to see augur in action, you can view some examples of augur instance in the following `sites `_. Current maintainers --------------------