{
  "date": "2013-08-19 18:20:41+02:00"
}
# Debian Contributors data exchange (first draft)

## Source-specific metadata

Each source must provide this kind of information about itself:

        {
          # Machine-readable
          name: string,
          # Human readable
          description: string,
          # Optional
          url: string,
          # All possible contribution types, with descriptions
          contributions: [
            {
               type: matches type in the contributions record,
               # Will be added to potfile server-side
               desc: string,
            }
          ]
        }

## Data about one person from one data source

This is the data record provided by a data source for one contributor:

        {
          # Normally one, if a data source has more and does not know how to choose,
          # they can list them all
          id: [
            {
              type: {login,email,fingerprint, wikiname},
              id: string,
            },
          ]
          # List of all kinds of contributions found in this source
          contributions: [
            {
              # untranslated short machine identifier for this kind of contribution
              type: string,
              # optional: if missing, defaults to previous 'begin' value. If never seen, defaults to 'today'
              begin: datetime,
              # optional: if missing, defaults to 'today'
              end: datetime,
              # Description, from a limited set, since we will collect them in potfile server-side
              # optional, points to some team-specific info page
              url: string,
          ],
        }

## Sending data to the Debian Contributors list

The idea is that data will be sent via a simple HTTPS post, together with a
shared secret. Details will follow.