diff --git a/docs/source/index.rst b/docs/source/index.rst index b7c22401d..4be2bd0a1 100644 --- a/docs/source/index.rst +++ b/docs/source/index.rst @@ -1,13 +1,13 @@ Seshat: Global History Databank =============================== -Project Documentation ---------------------- - This site includes documentation for the Seshat project, such as how-to guides and technical guidance applicable to those working on, or contributing to Seshat. The purpose is to provide a comprehensive knowledge sharing resource for all aspects of Seshat, including tools for working with the Seshat website and database, as well as reproducible research methods and code. +Project Roles +------------- + The documentation is divided into sections based on the role of the reader, which match the access level of accounts on the Seshat website. These roles are defined as follows: 1. Seshat Databank Admin: A member of the Seshat team responsible for the maintenance and development of the Seshat codebase, database and website. @@ -15,6 +15,9 @@ The documentation is divided into sections based on the role of the reader, whic 3. Seshat Expert: A collaborator with the necessary expertise and permission to approve or reject changes to the Seshat data. 4. Public User: An academic or other interested party who has created an account on the Seshat website to suggest data edits. +Project Documentation +--------------------- + .. toctree:: :maxdepth: 2 diff --git a/docs/source/team.rst b/docs/source/team.rst index cbe59aeb7..1da8e3fe7 100644 --- a/docs/source/team.rst +++ b/docs/source/team.rst @@ -1,14 +1,60 @@ Team ==== +A full list of people who have contributed to the project can be found on the project info website's `who we are `_ page. -Contact -------- +This page intends to be a useful place to find out who is currently working on the project, how to get in touch with them and what they can help you with. + +If you are new to the team, please add your details to the "Bios" section below. +To do this follow the guide on `how to update these docs `_. +Follow the example of the existing bios, adding the following sections: + +- **Who am I?** A brief introduction to who you are. +- **What can I help with?** A list of things you can help with. +- **Administrative privileges:** This is your access level on `seshat-db.com` which should be one of the following: + - Seshat Admin + - Research Assistant + - Seshat Expert + - Public User -Who can help me if... +.. note:: + Project roles that match the above access levels are defined `here `_. + +Bios ---- +Ed Chalstrey +~~~~~~~~~~~~ + +**Who am I?** + +- Research Software Engineer at the Alan Turing Institute +- Working on the Seshat project from November 2023 until March 2025 + +**What can I help with?** + +- Seshat website codebase, in particular the maps pages +- Seshat API Python package +- Cliopatria shape dataset +- Software Engineering & Data Science skills + +**Administrative privileges:** Seshat Admin + +Contact +------- + +If you need to contact someone from the team, email them or use one of the communication channels listed below. + +- For emails of Complexity Science Hub staff, please refer to the `CSH staff page `_. +- Alan Turing Institute staff emails are listed here: + - Ed Chalstrey: `echalstrey@turing.ac.uk` + - Pieter Francois: `pfrancois@turing.ac.uk` + - Kalle Westerling: `kwesterling@turing.ac.uk` + - Matilda Peruzzo: `mperuzzo@turing.ac.uk` Communication channels ---------------------- + +- Complexity Science Hub: *TODO* +- Alan Turing Institute: On the institute's Slack workspace, request to join the `#data-culture` and `#seshat-turing` channels. \ No newline at end of file