Metadata on Social Code Repositories
====================================

MeSoCoRe is a vocabulary which complements ontologies like schema.org/CodeMeta
and DOAP in describing software projects. While the latter are meant to describe
source code projects, MeSoCoRe describes VCS repositories of these projects.
This includes, for example, "stars" and "watchers" on platforms like GitHub, Gitlab,
or Gitea.

The namespace is ``https://www.softwareheritage.org/schema/2022/mesocore/``;
and it is meant to be used primarily in conjunction with schema.org/CodeMeta.

For example, here is a document using all three together:

.. code-block:: json

    {
      "@context": {
        "schema":"http://schema.org/",
        "codemeta": "https://codemeta.github.io/terms/",
        "mesocore": "https://www.softwareheritage.org/schema/2022/mesocore/",
        "wikidata": "http://www.wikidata.org/entity/"
      },
      "@type": "mesocore:CodeRepository",
      "@id": "https://github.com/octocat/linguist",
      "schema:name": "Linguist",
      "schema:description": "Language Savant",
      "codemeta:issueTracker": "https://github.com/octocat/linguist/issues",
      "mesocore:vcs": {
        "@type": "schema:SoftwareApplication",
        "@id": "wikidata:Q186055",
        "schema:name": "Git"
      },
      "mesocore:containsSourceCode": {
        "@type": "schema:SoftwareSourceCode",
        "schema:name": "Linguist",
        "schema:description": "This library is used on GitHub.com to detect blob languages"
      },
      "mesocore:stargazerCount": 146,
      "mesocore:subscriberCount": 123,
      "mesocore:forkCount": 138,
      "mesocore:forkOf": {
        "@type": "mesocore:CodeRepository",
        "@id": "https://github.com/github/linguist",
        "schema:name": "Linguist"
      }
    }


Types
-----

CodeRepository
^^^^^^^^^^^^^^

Represents one instance of a VCS repository, such as a Git/Mercurial clone,
a Subversion checkout, a BZR branch, ...

For example, https://github.com/github/linguist and https://github.com/octocat/linguist
are two different repository objects.

This is the main object type that MeSoCoRe aims to describe.

This subtly differs from https://schema.org/SoftwareSourceCode as the latter
represents the source code independently of the medium it is stored in.

Relation properties
-------------------

Social properties
-----------------

Configuration properties
------------------------

Statistics properties
---------------------