Indexers will translate GitHub/Gitlab/Gogs/Gitea/...'s API response into this ontology.
The grammar itself would mostly likely be JSON-LD so it is compatible with our other metadata (CodeMeta/schema.org)
Current options:
* create our own
* pick an existing forge's ontology, and map everything to it -> this would eventually turn into inventing our own ontology anyway
* [[ https://forgefed.peers.community/vocabulary.html | ForgeFed's ontology ]] (and ActivityPub) -> not suitable for us; at the moment it's a disjoint set from what we want (ForgeFed only cares about issues and PRs)
* GHTorrent -> I am told they are working on a generic way to represent data that isn't tied to GitHub, but I cannot find it
* Wikidata (eg. https://www.wikidata.org/wiki/Property:P9100 )
* DOAP
| Description | [[ https://docs.github.com/en/rest/repos/repos#get-a-repository | GitHub ]] | [[ https://docs.gitlab.com/ee/api/projects.html#get-single-project | Gitlab ]] | [[ https://try.gitea.io/api/swagger#/repository/repoGet | Gitea ]] |schema.org
|/ Codemeta | Forgefed | Wikidata | DOAP |
| -- | -- | -- | -- | -- | -- | -- | --
| -- |
| Project name | name | name | name / full_name
| schema:name
| Project avatar | | | avatar_url
| schema:image
| Owner name | owner.login | namespace.name |
|
| Owner avatar | owner.avatar_url | namespace.avatar_url
| |
| Owner homepage | ? | ? | |
| description | description | description | description | schema:description
| description | description | description | description
| | homepage | | website| | homepage | | website | schema:url
| whether it's a fork | fork | | fork
|
| what it's a fork of | parent + source | | | schema:isBasedOn
| wh
atether it's a
fork of | parent + sourcemirror | ? | | |
| wh
etherat it's a mirror
| of | source? |
| |
| what it's a mirror of | source? | || | forks_count | forks_count | forks_count |
| |
forks_count | forks_count | forks_count
|created_at | created_at | created_at |
cschema:dateCreat
ed_ated/codemeta:dateCreated
| | updated_at | last_activity_at | updated_at
| schema:dateModified/codemeta:dateModified
| | pushed_at |
| |
| |
stargazers_count | star_count | stars_count| | | schema:datePublished/codemeta:datePublished
| |
stargazers_count | star_count | stars_count |
| | watchers / watchers_count | | watchers_count
|
| | open_issues / open_issues_count | open_issues_count | open_issues_count
|
| | | | open_pr_counter |
| | visibility (private/internal/public) | visibility (private/internal/public) | internal + private (booleans) |
| | default_branch | default_branch | default_branch |
| programming language | language | | language | codemeta:programmingLanguage
| || SPDX id | license.spdx_id | | |
| license url | |
open_pr_counterlicense.html_url / license.source_url | | codemeta:license
|
| visibility (private/internal/public) | visibility (private/internal/public) | internal + private (booleans)possibly inconsistent | | license.nickname | |
| possibly inconsistent | license.key | license.key | |
| possibly inconsistent | license.name | license.name | |
| Tags/labels | topics | topics | | schema:keywords/codemeta:keywords
| |
default_branch | default_branch | default_branchhas_issues | | has_issues |
| | | | | codemeta:issueTracker
| programming language | language | | language| | | | internal_tracker.* + external_tracker.* | |
| |
license.spdx_i(always true if repo not disabled) | merge_request_enabled |
|has_pull_requests |
| | |
license.nickname |jobs_enabled | |
| possibly inconsistent | license.key | license.key || | | snippets_enabled | |
| | | can_create_merge_request_in | |
| possibly inconsistent | license.name | license.name || | | resolve_outdated_diff_discussions | |
|
Tags/labels | topics | topics(different semantics) | | merge_method | allow_merge_commits + allow_rebase + allow_rebase_explicit + allow_squash_merge + default_merge_style |
| |
has_issues | | has_issues
| | | | internal_tracker.* + external_tracker.*
| | (always true if repo not disabled) | merge_request_enabled | has_pull_requests
| | | jobs_enabled| squash_option | |
| |
| snippets_enabled |has_projects | | has_projects |
| |
| can_create_merge_request_in |has_downloads | | |
| |
| resolve_outdated_diff_discussions |has_wiki | wiki_enabled | has_wiki |
|
(different semantics) | | merge_method | allow_merge_commits + allow_rebase + allow_rebase_explicit + allow_squash_merge + default_merge_style
| | | squash_option| | | external_wiki.* |
| | has_p
rojects | | has_projects
| | has_downloadsages | | |
| |
has_wiki | wiki_enablarchived |
has_wiki
| | | | external_wiki.*
| | has_pages | |archived | archived |
| |
archived | archived | archived
| | disableddisabled | | |
| | | | empty
| | | mirror | mirror
| | | | mirror_interval
| | | | mirror_updated
| | | | original_url
| | | merge_commit_template |
| | |
squash_commit_template |mirror | mirror |
| | |
marked_for_deletion_on || mirror_interval |
|
not documented | size | |
| not documented | | | size
| | | statistics.commit_count| | | mirror_updated |
| | | | original_url |
| | | merge_commit_template | |
| | | squash_commit_template | |
| | | marked_for_deletion_on | |
| not documented | size | | |
| not documented | | | size |
| | | statistics.
commit_count | |
| | | statistics.storage_size
|| |
| | | statistics.repository_size
| |
| | | statistics.<a few more>
| |
| | | | release_counter
|