id.sifa.profile.involvement
Schema Diff
+4 -0
Compatibility Analysis
Backward Compatible
Backward compatible. 2 non-breaking changes.
Non-Breaking Changes (2)
- AddedVertex AddedVertex { vertex_id: "id.sifa.profile.involvement:body.isPrimary" }
- AddedEdge AddedEdge { src: "id.sifa.profile.involvement:body", tgt: "id.sifa.profile.involvement:body.isPrimary", kind: "prop", name: Some("isPrimary") }
Migration Guidance
Added Elements
AddedVertex { vertex_id: "id.sifa.profile.involvement:body.isPrimary" }
Additional Notes
- Non-breaking: AddedEdge { src: "id.sifa.profile.involvement:body", tgt: "id.sifa.profile.involvement:body.isPrimary", kind: "prop", name: Some("isPrimary") }
1
1
{
2
2
"$type": "com.atproto.lexicon.schema",
3
3
"defs": {
4
4
"main": {
5
5
"description": "Record representing one involvement — an ongoing role and/or a body of discrete contributions to a single upstream.",
6
6
"key": "tid",
7
7
"record": {
8
8
"properties": {
9
9
"collaborators": {
10
10
"description": "Other people who worked on this alongside you. Each entry is a claim by the record author and is not self-verifying: the named person supplies the other half by publishing an id.sifa.confirmation record whose subject is this record and whose relation is id.sifa.defs#collaborator. Until they do, consumers must render the entry without their display name, avatar, or profile link. Confirming never puts this record on their profile: it lives in the author's repository and the author can rename it at any time.",
11
11
"items": {
12
12
"ref": "id.sifa.defs#projectMemberRef",
13
13
"type": "ref"
14
14
},
15
15
"maxLength": 50,
16
16
"type": "array"
17
17
},
18
18
"createdAt": {
19
19
"description": "Client-declared timestamp when this record was originally created.",
20
20
"format": "datetime",
21
21
"type": "string"
22
22
},
23
23
"description": {
24
24
"description": "What the user did and why it mattered.",
25
25
"maxGraphemes": 5000,
26
26
"maxLength": 50000,
27
27
"type": "string"
28
28
},
29
29
"endedAt": {
30
30
"description": "End date in YYYY-MM or YYYY-MM-DD format. Omit if ongoing.",
31
31
"type": "string"
32
32
},
33
33
"entityRef": {
34
34
"description": "Portable, app-neutral identifier for the upstream the user selected from a resolver dropdown: a Wikidata Q-ID URI (http://www.wikidata.org/entity/Q...), a ROR URI, or an LEI URI. Enables deterministic resolution to a canonical entity even before the upstream claims an ATproto account. Absent for free-text or one-off entries.",
35
35
"format": "uri",
36
36
"type": "string"
37
37
},
38
+
"isPrimary": {
39
+
"description": "Whether this is the user's primary current involvement, surfaced in profile Highlights. Only ongoing entries may be primary.",
40
+
"type": "boolean"
41
+
},
38
42
"kind": {
39
43
"description": "The nature of the involvement. Drives the display heading (Open Source / Community / Volunteering / Civic).",
40
44
"knownValues": [
41
45
"id.sifa.defs#involvementOpenSource",
42
46
"id.sifa.defs#involvementCommunity",
43
47
"id.sifa.defs#involvementCharity",
44
48
"id.sifa.defs#involvementCivic",
45
49
"id.sifa.defs#involvementOther"
46
50
],
47
51
"type": "string"
48
52
},
49
53
"labels": {
50
54
"description": "Self-label values for this record.",
51
55
"refs": [
52
56
"com.atproto.label.defs#selfLabels"
53
57
],
54
58
"type": "union"
55
59
},
56
60
"links": {
57
61
"description": "Public artifacts proving the involvement (PRs, releases, talk recordings, published translations).",
58
62
"items": {
59
63
"ref": "id.sifa.defs#artifactLink",
60
64
"type": "ref"
61
65
},
62
66
"maxLength": 50,
63
67
"type": "array"
64
68
},
65
69
"location": {
66
70
"description": "Where the involvement takes place. Sifa enforces ISO 3166-1 alpha-2 country codes at the app layer.",
67
71
"ref": "community.lexicon.location.address",
68
72
"type": "ref"
69
73
},
70
74
"role": {
71
75
"description": "The user's role (e.g. 'Maintainer', 'Translator', 'Organizer', 'Contributor').",
72
76
"maxGraphemes": 256,
73
77
"maxLength": 2560,
74
78
"type": "string"
75
79
},
76
80
"sameAs": {
77
81
"description": "The same involvement as recorded on another person's profile. Set when you keep your own entry for work someone else has also recorded, so consumers can tell the two describe one thing rather than showing it twice. Each side stays its own record: the other person cannot edit yours, and yours does not change theirs. Resolve by AT-URI, since they will keep editing their copy.",
78
82
"ref": "id.sifa.defs#externalRecordRef",
79
83
"type": "ref"
80
84
},
81
85
"skills": {
82
86
"description": "Skills demonstrated by this involvement. Each entry is a URI reference to an id.sifa.profile.skill record owned by the same DID.",
83
87
"items": {
84
88
"ref": "id.sifa.defs#skillRef",
85
89
"type": "ref"
86
90
},
87
91
"maxLength": 50,
88
92
"type": "array"
89
93
},
90
94
"startedAt": {
91
95
"description": "Start date in YYYY-MM or YYYY-MM-DD format. Freeform (NOT strict datetime) to allow partial dates and importer writes.",
92
96
"type": "string"
93
97
},
94
98
"upstream": {
95
99
"description": "Name of the project, community, event, or cause (e.g. 'atproto', 'Linux kernel', 'PyCon NL'). Optional — a one-off contribution need not name an organization.",
96
100
"maxGraphemes": 256,
97
101
"maxLength": 2560,
98
102
"type": "string"
99
103
},
100
104
"upstreamDid": {
101
105
"description": "DID of the upstream's ATproto account, if one exists.",
102
106
"format": "did",
103
107
"type": "string"
104
108
},
105
109
"upstreamUrl": {
106
110
"description": "Primary URL of the upstream (project homepage, repo, event site).",
107
111
"format": "uri",
108
112
"type": "string"
109
113
}
110
114
},
111
115
"required": [
112
116
"kind",
113
117
"createdAt"
114
118
],
115
119
"type": "object"
116
120
},
117
121
"type": "record",
118
122
"x-skos:broadMatch": [
119
123
"org:Membership"
120
124
],
121
125
"x-skos:note": "The kind known values have no external equivalent."
122
126
}
123
127
},
124
128
"description": "Uncompensated involvement with an external project, community, event, or cause the user does not own or run — open-source, community, charity, or civic work. Distinct from paid roles (position), things you own (project), and paid employment.",
125
129
"id": "id.sifa.profile.involvement",
126
130
"lexicon": 1
127
131
}