Skip to content

UoMResearchIT/RSESkillsGraph

Repository files navigation

About

This is the RSE Skills Graph web app written in Python 3 with the Flask framework. Original code by Steve Pettifer; mods by Ian Cottam, Colin Morris, Ian Hinder; The University of Manchester; Apache 2 Licence

How to Use

There is an existing deployment hosted here. You can click on RSEs' names and see their skills, as well as search by skill.

How to Add / Update

To add or update a person's entry, modify the JSON entry in people.json. People with spaces in their surname should use underscore e.g. Le_Blanc. It will be displayed properly with a space. The "interests" for each person need to come from Wikipedia main entries - that is our controlled vocabulary.

The JSON is fairly obvious. There are two levels, called "interests" and "technologies". Interests are clickable, but technologies not. Some browsers let you right-click a technology and look up its definition. In the RSE-skills application we really just use Interests, so everything is clickable. We do use technologies sparingly as commentary.

What do I add?

You should add "interests" if you feel confident on being selected to work on a project where that technology is the main technology used then add it as an interest.

How to Install / Run

The requirements.txt should contain the Python modules needed.

You also need to install the C-based GraphViz library: e.g. brew install graphviz (MacOS)

To run locally: flask run

Docker

There is a Dockerfile within the repository from which a docker image can be built and run. See Running in Docker.

There is an instance of this software running at the University of Manchester on a Research Virtual Machine.

There is documentation for running in Microsoft Azure: Running in Docker on Azure.

Headshots

Portrait images of people can be included in an images directory, but we don't use that faclity at the moment.

Possible Improvements

  • A self-service web-frontend for editing the files