From 92d0cfcfe02dfdd788e473dac83f5b268d4470ec Mon Sep 17 00:00:00 2001
From: verena <9377970+vpchung@users.noreply.github.com>
Date: Mon, 5 Feb 2024 14:45:21 -0800
Subject: [PATCH] reformat readme
---
README.md | 44 +++++++++++++++++++++++++++++++++++---------
1 file changed, 35 insertions(+), 9 deletions(-)
diff --git a/README.md b/README.md
index 0e40482..2dd5dc3 100644
--- a/README.md
+++ b/README.md
@@ -3,9 +3,7 @@
- Data models and standard terms used by the
- Cancer Complexity Knowledge Portal
- (CCKP)
+ Data models and standard terms used by MC2 Center
@@ -17,26 +15,54 @@
## Overview
-This repository contains the released versions of the JSON-LD schemas for the CCKP, and more broadly, MC2 Center. You can learn more about the schemas/data models and other aspects of this project in our portal documentation - coming soon! The MC2 Center data model is in both a csv and jsonld format. It is separated into modules (see the module folder) where various peices of the data model can be updated, including the standard terms/valid values (please see "Adding a new valid value" below). To edit the data model, create a new branch, make edits, and when ready, create a pull request. Once the new branch is merged with the main, a new mc2.model.csv and mc2.model.jsonld will automatically update. See documentation below for more information.
+This repository contains the released versions of the JSON-LD schemas for the
+[Cancer Complexity Knowledge Portal] (CCKP), and more broadly, MC2 Center.
+You can learn more about the schemas/data models and other aspects of this
+project in our portal documentation - coming soon! The MC2 Center data model
+is in both a csv and jsonld format. It is separated into modules (see the
+module folder) where various peices of the data model can be updated,
+including the standard terms/valid values (please see "Adding a new valid
+value" below). To edit the data model, create a new branch, make edits, and
+when ready, create a pull request. Once the new branch is merged with `main`,
+a new `mc2.model.csv`` and `mc2.model.jsonld`` will automatically update. See
+documentation below for more information.
## Updating the Data Model
-
### Adding a new valid value
When a new valid value needs to be added to the data model:
-1. Research the term and make sure we do not already have a synonym for it that exists. Using NCIt is excellent for this, though sometimes looking outside of NCIt is necessary. If we do currently have a synonym in use, add the valid value as a "non preferred term" in the applicable attribute csv in the modules folder. If not:
+1. Research the term and make sure we do not already have a synonym for it that
+exists. Using NCIt is excellent for this, though sometimes looking outside of
+NCIt is necessary. If we do currently have a synonym in use, add the valid value
+as a "non preferred term" in the applicable attribute csv in the modules folder.
+If not:
+
+2. Add the valid value in the "attribute" column of the applicable csv in the
+appropriate module folder. E.g. if a new tumor type needs to be added go to
+the tumorType.csv and add the new term in the attribute column). Fill out the
+rest of the columns as completely as possible, this includes the description,
+the required column, parent column, source column, non preferred terms column,
+the ontology identifier, url, NCIt Code, and any notes. Please make a note of
+who added it and the date.
-2. Add the valid value in the "attribute" column of the applicable csv in the appropriate module folder. E.g. if a new tumor type needs to be added go to the tumorType.csv and add the new term in the attribute column). Fill out the rest of the columns as completely as possible, this includes the description, the required column, parent column, source column, non preferred terms column, the ontology identifier, url, NCIt Code, and any notes. Please make a note of who added it and the date.
+3. Be sure to look up any synonyms and add to the "non preferred terms" column.
+This will make annotating easier in the future.
-3. Be sure to look up any synonyms and add to the "non preferred terms" column. This will make annotating easier in the future.
+4. When ready to release a new version of the data model and a pull request is
+made, the valid values will automatically get added to `mc2.model.csv` and its
+JSON-LD file.
-4. When ready to release a new version of the data model and a pull request is made, the valid values will automatically get added to `mc2.model.csv` and its JSON-LD file.
## Release Notes
+This repository adopts [Semantic Versioning] (SemVer), which provides a
+standard way of versioning software based on meaningful changes in
+functionality.
+
+
## Documentation
The documentation uses [MkDocs], [mkdocs-table-reader-plugin], and the