Skip to content
Draft
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
21 changes: 21 additions & 0 deletions recommendations/B_Mapping_Standards/tools/bartoc.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,21 @@
# BARTOC

The
[Basic Register of Thesauri, Ontologies, & Classifications (BARTOC)](https://bartoc.org)
is a database of Knowledge Organization Systems and KOS related registries.

## Artifacts

- Source Code (https://github.com/gbv/bartoc.org)
- Downloads (https://bartoc.org/download)
- API (https://bartoc.org/api/)

## Training Material

- [Contribution Guidelines](https://bartoc.org/contributing)

## Publications

See list on https://bartoc.org/about

- [Collecting Distributed KOSs and Building Meta Information](https://nkos.dublincore.org/2022NKOSworkshop/Park-Collecting%20Distributed%20KOS.pdf)
47 changes: 47 additions & 0 deletions recommendations/B_Mapping_Standards/tools/semantic-farm.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,47 @@
# Semantic Farm

The Semantic Farm is an open source, domain-agnostic, community curated semantic
space registry, meta-registry, and compact identifier resolver. Here's what that
means:

1. **Registry** A collection of prefixes and metadata for ontologies,
terminologies, and other resources that assign ( persistent) identifiers.
Some other well-known registries are
[Identifiers.org](https://identifiers.org) (originally for the life
sciences), and the [BARTOC](https://bartoc.org) (originally for the
humanities).
2. **Metaregistry** A collection of metadata about registries and mappings
between their constituent prefixes.
3. **Resolver** A tool for mapping
[compact URIs (CURIEs)](https://www.w3.org/TR/2010/NOTE-curie-20101216/) of
the form `prefix:identifier` to HTML and structured content providers
4. **Open Source** Anyone can
[suggest improvements](https://github.com/biopragmatics/bioregistry/issues/new/choose)
or make pull requests to update the underlying database, which is stored in
[JSON on GitHub](https://github.com/biopragmatics/bioregistry/blob/main/src/bioregistry/data/bioregistry.json)
where the community can engage in an open review process.
5. **Domain Agnostic** The concept behind the Semantic Farm was first piloted in
the biomedical community with [the Bioregistry](https://bioregistry.io). Now,
the underlying technology is fully generic for all domains including
engineering, humanities, and beyond.
6. **Community** Governed by public, well-defined
[contribution guidelines](https://github.com/biopragmatics/bioregistry/blob/main/docs/CONTRIBUTING.md),
[code of conduct](https://github.com/biopragmatics/bioregistry/blob/main/docs/CODE_OF_CONDUCT.md),
and
[project governance](https://github.com/biopragmatics/bioregistry/blob/main/docs/GOVERNANCE.md)
to promote the project's inclusivity and longevity.

## Artifacts

- Source code (https://github.com/biopragmatics/bioregistry/)
- Website (https://semantic.farm/)
- API Documentation (https://semantic.farm/docs)

## Training Material

- [New Prefix Guidelines](https://github.com/biopragmatics/bioregistry/blob/main/docs/CONTRIBUTING.md)
- [New Prefix Tutorial](https://www.youtube.com/watch?v=e-I6rcV2_BE&t=3s&pp=ygULYmlvcmVnaXN0cnnSBwkJogoBhyohjO8%3D)

## Publications

- [Unifying the identification of biomedical entities with the Bioregistry](https://doi.org/10.1038/s41597-0)
3 changes: 3 additions & 0 deletions recommendations/D_Development_Best_Practices/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -140,6 +140,9 @@ existing terminologies before and while developing a new terminology.
- adhere to a minimal metadata standard
- see Metadata for Ontology Description (MOD)

See [Semantic Farm and BARTOC](semantic-farm-and-bartoc.md) for discussion of
recommendations for indexing

## Tooling

### Ontology Development Kit (ODK)
Expand Down
Original file line number Diff line number Diff line change
@@ -0,0 +1,25 @@
# Semantic Farm and BARTOC

The Semantic Farm (https://semantic.farm) and the Basic Registry of Thesauri,
Ontologies, and Classifications (BARTOC; https://bartoc.org) both capture
metadata describing resources that assign identifiers.

The Semantic Farm already is able to sync content from BARTOC, and in the
future, BARTOC will be able to sync content from the Semantic Farm.

This document serves as a guide to help NFDI consortium members understand their
similarities, differences, and decide when to use one or both.

## When to use BARTOC

Key use cases:

1. If you want to use Cocoda as a mapping curation system

## When to use the Semantic Farm

1. If you want to capture information about any kind of identifiers space that
isn't a terminology or ontology (e.g., a database like UniProt or system like
DOI)
2. If you want to use SSSOM Curator as a mapping curation system
3. If you want to build collections of resources (e.g., for reporting)