The RepositoryGuide application aims at helping development teams gain insights into their teamwork based on the produced GitHub project data.
RepositoryGuide uses the public Github API to extract a set of key team measures for a GitHub repository. We envision the produced visualizations to be helpful in Retrospective meetings, where teams can analyze and interpret their projet data of an iteration. The focus of the included visualizations is on facilitating discussions in teams that can lead to collaborative software process improvement.
To set up a configuration for your team open the settings tab and follow the instructions there. Then you can edit your teams (stored in your own config), select your team and view the visualizations.
- Clone the repository:
git@github.com:hpi-epic/repositoryguide.gitand go into the repository folder - Make sure you've installed node. If not download and install it from here
- Run
npm installin the root of the repository - Generate a personal access token for GitHub using these instructions
- Host the project on a local server, opening
index.htmldirectly won't work. The WebStorm IDE offers a local development server, or run one usingpython3 -m http.server. - Download the config to have an empty version of a
config.json file. Replace"github_access_token": ""with"github_access_token": "<your token>" - Load the edited config into the application.
- The preparations are now done. Enjoy your metrics. :-)
To follow the codestyle used in this repository you need Prettier and Eslint. After having setup the project you need to setup these tools. For Webstorm follow the following tutorials:
- ESLint
- Follow the following steps from this tutorial
- Prettier
- Follow the following steps from this tutorial