diff --git a/README.md b/README.md index 31353f31a8..0e244873ff 100644 --- a/README.md +++ b/README.md @@ -14,18 +14,17 @@ branch | status ## What is Augur? -Relational. Easy to pull data out of for open source software metrics. Collection is verifiably accurate. Augur is a software suite for collecting and measuring structured data +Augur is a software suite for collecting and measuring structured data about [free](https://www.fsf.org/about/) and [open-source](https://opensource.org/docs/osd) software (FOSS) communities. -We gather trace data for a group of repositories, normalize -it into our data model, and provide a variety of metrics about said -data. The structure of our data model enables us to synthesize data -across various platforms to provide meaningful context for meaningful -questions about the way these communities evolve. +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. We are a [CHAOSS](https://chaoss.community) project, and 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](https://chaoss.community/participate/). +metrics are implementations of the metrics defined by our awesome community. You can find a full list of them [here](https://chaoss.community/metrics/). + +For more information on [how to get involved on the CHAOSS website](https://chaoss.community/participate/). ## Collecting Data diff --git a/augurface/package-lock.json b/augurface/package-lock.json index c9fde6cc47..90fc4be5fa 100644 --- a/augurface/package-lock.json +++ b/augurface/package-lock.json @@ -11,7 +11,7 @@ "core-js": "^3.6.5", "lodash": "^4.17.21", "node-inspect": "^2.0.0", - "vue": "^2.6.10", + "vue": "^2.6.14", "vue-click-outside": "^1.1.0", "vue-position-sticky": "^0.2.1", "vue-router": "^3.4.3", @@ -12175,9 +12175,9 @@ } }, "node_modules/shell-quote": { - "version": "1.7.2", - "resolved": "https://registry.npmjs.org/shell-quote/-/shell-quote-1.7.2.tgz", - "integrity": "sha512-mRz/m/JVscCrkMyPqHc/bczi3OQHkLTqXHEFu0zDhK/qfv3UcOA4SVmRCLmos4bhjr9ekVQubj/R7waKapmiQg==", + "version": "1.7.3", + "resolved": "https://registry.npmjs.org/shell-quote/-/shell-quote-1.7.3.tgz", + "integrity": "sha512-Vpfqwm4EnqGdlsBFNmHhxhElJYrdfcxPThu+ryKS5J8L/fhAwLazFZtq+S+TWZ9ANj2piSQLGj6NQg+lKPmxrw==", "dev": true }, "node_modules/signal-exit": { @@ -13893,9 +13893,9 @@ "dev": true }, "node_modules/vue": { - "version": "2.6.12", - "resolved": "https://registry.npmjs.org/vue/-/vue-2.6.12.tgz", - "integrity": "sha512-uhmLFETqPPNyuLLbsKz6ioJ4q7AZHzD8ZVFNATNyICSZouqP2Sz0rotWQC8UNBF6VGSCs5abnKJoStA6JbCbfg==" + "version": "2.6.14", + "resolved": "https://registry.npmjs.org/vue/-/vue-2.6.14.tgz", + "integrity": "sha512-x2284lgYvjOMj3Za7kqzRcUSxBboHqtgRE2zlos1qWaOye5yUmHn42LB1250NJBLRwEcdrB0JRwyPTEPhfQjiQ==" }, "node_modules/vue-click-outside": { "version": "1.1.0", @@ -25012,9 +25012,9 @@ "dev": true }, "shell-quote": { - "version": "1.7.2", - "resolved": "https://registry.npmjs.org/shell-quote/-/shell-quote-1.7.2.tgz", - "integrity": "sha512-mRz/m/JVscCrkMyPqHc/bczi3OQHkLTqXHEFu0zDhK/qfv3UcOA4SVmRCLmos4bhjr9ekVQubj/R7waKapmiQg==", + "version": "1.7.3", + "resolved": "https://registry.npmjs.org/shell-quote/-/shell-quote-1.7.3.tgz", + "integrity": "sha512-Vpfqwm4EnqGdlsBFNmHhxhElJYrdfcxPThu+ryKS5J8L/fhAwLazFZtq+S+TWZ9ANj2piSQLGj6NQg+lKPmxrw==", "dev": true }, "signal-exit": { @@ -26428,9 +26428,9 @@ "dev": true }, "vue": { - "version": "2.6.12", - "resolved": "https://registry.npmjs.org/vue/-/vue-2.6.12.tgz", - "integrity": "sha512-uhmLFETqPPNyuLLbsKz6ioJ4q7AZHzD8ZVFNATNyICSZouqP2Sz0rotWQC8UNBF6VGSCs5abnKJoStA6JbCbfg==" + "version": "2.6.14", + "resolved": "https://registry.npmjs.org/vue/-/vue-2.6.14.tgz", + "integrity": "sha512-x2284lgYvjOMj3Za7kqzRcUSxBboHqtgRE2zlos1qWaOye5yUmHn42LB1250NJBLRwEcdrB0JRwyPTEPhfQjiQ==" }, "vue-click-outside": { "version": "1.1.0", diff --git a/docs/source/development-guide/installation.rst b/docs/source/development-guide/installation.rst index db77fe2784..d98a909874 100644 --- a/docs/source/development-guide/installation.rst +++ b/docs/source/development-guide/installation.rst @@ -1,20 +1,20 @@ -Installing for development +Installing for Development ============================= -Installing Augur for local development is pretty similar to the normal installation process. This guide will primarily detail the differences between the two instead of regurgitating all the information in the `Getting Started <../getting-started/toc.html>`_ section. If you are completely new to Augur, we recommend following the aforementioned getting started section first; once you feel more comfortable with Augur and how to use it, come back to this document. +Installing Augur for local development is pretty similar to the normal installation process. This guide will primarily detail the differences between the two instead of regurgitating all the information in the `Getting Started <../getting-started/toc.html>`_ section. If you are completely new to Augur, we recommend following the aforementioned `Getting Started <../getting-started/toc.html>`_ section first; once you feel more comfortable with Augur and how to use it, come back to this document. -Setting up the database +Setting up the Database ------------------------ -If they so desired, developers can set up a persistent instance of PostgreSQL on either the local machine or a remote server. The instructions for doing so can be found in the `database <../getting-started/database.html>`_ portion of the Getting Started section +If they so desire, developers can set up a persistent instance of PostgreSQL on either the local machine or a remote server. The instructions for doing so can be found in the `database <../getting-started/database.html>`_ portion of the Getting Started section -However, during development, you might find that you need to reset your database often, especially if you are working on the data collection components of Augur. To this end, we recommend developers make use of our Docker images to quickly provision and terminate database instances in a lightweight and reproducible manner. +However, during development, you might find that you need to reset your database often, especially if you are working on the data collection components of Augur. To this end, we recommend developers make use of our `Docker images <../docker/docker.html>`_ to quickly provision and terminate database instances in a lightweight and reproducible manner. More information about Augur's Docker images can be found `here <../docker/docker.html>`_. If you're new to our Docker process, we recommend following the `introduction section <../docker/toc.html>`_ first. -Installing from source +Installing from Source ---------------------------- The process for installing Augur's source code for development is essentially the same as detailed in the `Installation <../getting-started/installation.html>`_ section of the Getting Started guide. diff --git a/docs/source/index.rst b/docs/source/index.rst index 718adb4435..1e84ef5c6c 100755 --- a/docs/source/index.rst +++ b/docs/source/index.rst @@ -5,7 +5,7 @@ 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! +Augur's documentation; (pronounced awe-grrr), is split into seven (7) parts. If you’re new to the project you can find out more on the software `here `_. We recommend giving it a once-over as a gentle introduction, otherwise, feel free to hop right into the docs! .. toctree:: :maxdepth: 2 @@ -28,7 +28,20 @@ Augur's documentation; (pronounced awe-grrr), is split into seven (7) parts. If :width: 700 :alt: Development guide image overview of augur -If you want to see augur in action, you can view CHAOSS’s augur instance at http://augur.chaoss.io + +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 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 `_. + +If you want to see augur in action, you can view CHAOSS’s augur instance `here `_. Current maintainers diff --git a/docs/source/quick-start.rst b/docs/source/quick-start.rst index c60cb48652..bf1c1f6e37 100644 --- a/docs/source/quick-start.rst +++ b/docs/source/quick-start.rst @@ -7,7 +7,7 @@ Get going fast! Intended for folks familiar with setting up DevOps environments. Setting up VirtualBox ~~~~~~~~~~~~~~~~~~~~~~~ -- Go to the official box website to download using this link `https://www.virtualbox.org/` +- Go to the official box website to download using this `link `_. - Download VirtualBox for "Windows hosts". .. image:: development-guide/images/A2.png :width: 600