README-dev.md: improve introduction

This commit is contained in:
Alan Orth 2022-01-30 12:31:30 +03:00
parent e202cbe3de
commit 88ba512cf1
Signed by: alanorth
GPG Key ID: 0FB860CC9C45B1B9

View File

@ -1,6 +1,15 @@
# Technical Documentation # Technical Documentation
This document provides technical information about various workflows related to updating and editing the schema and documentation site. This document provides technical information about various workflows related to updating and editing the schema and documentation site.
## About This Project
The ISEAL Core Metadata Set is maintained primarily in CSV format. This decision was made to maintain a balance between being human and machine readable. Currently the project consists of:
- The ISEAL Core Metadata Set, which lives in `data/iseal-core.csv`
- The FSC<sup>®</sup> extension, which lives in `data/fsc.csv`
From the CSV we use a series of Python scripts to create the RDF ([TTL](https://en.wikipedia.org/wiki/Turtle_(syntax))) representations of the schema as well as the HTML documentation site. All of this is automated using GitHub Actions (see `.github/workflows`) whenever there is a new commit in the repository.
## General Requirements ## General Requirements
- Python 3.7+ - Python 3.7+