This repository has been archived by the owner on Aug 9, 2022. It is now read-only.
-
Notifications
You must be signed in to change notification settings - Fork 9
/
Copy pathschema-2.0.0.json
294 lines (292 loc) · 12.4 KB
/
schema-2.0.0.json
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
{
"$schema": "http://json-schema.org/draft-04/schema#",
"title": "Code.gov Inventory",
"description": "A federal source code catalog",
"type": "object",
"properties": {
"version": {
"type": "string",
"description": "The version of the metadata schema in use. Implements semantic versioning 2.0.0 rules as defined at http://semver.org"
},
"measurementType": {
"type": "object",
"description": "An object containing description of the open source measurement method.",
"properties": {
"method": {
"type": "string",
"enum": [
"linesOfCode",
"modules",
"cost",
"projects",
"systems",
"other"
],
"description": "An enumerated list of methods for measuring the open source requirement: (1) cost: Cost of software development, (2) systems: system certification and accreditation boundaries, (3) projects: A complete software solution / project, (4) modules: A self-contained module from a software solution, (5) linesOfCode: Source lines of code, (6) other: Another measurement method not referenced above"
},
"ifOther": {
"type": "string",
"description": "A one- or two- sentence description of the measurement type used, if 'other' is selected as the value of 'method' field."
}
},
"additionalProperties": false
},
"agency": {
"type": "string",
"description": "The agency acronym for Clinger Cohen Act agency, as defined by the United States Government Manual."
},
"releases": {
"type": "array",
"items": {
"type": "object",
"description": "An object containing each versioned source code release made available.",
"properties": {
"name": {
"type": "string",
"description": "The name of the release."
},
"version": {
"type": "string",
"description": "The version for this release. For example, '1.0.0'."
},
"organization": {
"type": "string",
"description": "The organization or component within the agency to which the releases listed belong. For example, '18F' or 'Navy'."
},
"description": {
"type": "string",
"description": "A one or two sentence description of the release."
},
"permissions": {
"type": "object",
"description": "An object containing description of the usage/restrictions regarding the release.",
"properties": {
"licenses": {
"type": ["array", "null"],
"items": {
"type": "object",
"properties": {
"URL": {
"type": "string",
"format": "uri",
"description": "The URL of the release license, if available. If not, null should be used."
},
"name": {
"type": "string",
"description": "An abbreviation for the name of the license. For example, 'CC0' or 'MIT'."
}
},
"additionalProperties": false
}
},
"usageType": {
"type": "string",
"description": "A list of enumerated values which describes the usage permissions for the release: (1) openSource: Open source; (2) governmentWideReuse: Government-wide reuse; (3) exemptByLaw: The sharing of the source code is restricted by law or regulation, including—but not limited to—patent or intellectual property law, the Export Asset Regulations, the International Traffic in Arms Regulation, and the Federal laws and regulations governing classified information; (4) exemptByNationalSecurity: The sharing of the source code would create an identifiable risk to the detriment of national security, confidentiality of Government information, or individual privacy; (5) exemptByAgencySystem: The sharing of the source code would create an identifiable risk to the stability, security, or integrity of the agency’s systems or personnel, (6) exemptByAgencyMission: The sharing of the source code would create an identifiable risk to agency mission, programs, or operations; (7) exemptByCIO: The CIO believes it is in the national interest to exempt sharing the source code; (8) exemptByPolicyDate: The release was created prior to the M-16-21 policy (August 8, 2016)",
"enum": [
"openSource",
"governmentWideReuse",
"exemptByLaw",
"exemptByNationalSecurity",
"exemptByAgencySystem",
"exemptByAgencyMission",
"exemptByCIO",
"exemptByPolicyDate"
],
"additionalProperties": false
},
"exemptionText": {
"type": ["string", "null"],
"description": "If an exemption is listed in the 'usageType' field, this field should include a one- or two- sentence justification for the exemption used."
}
},
"additionalProperties": false,
"required": ["licenses", "usageType"]
},
"tags": {
"type": "array",
"description": "An array of keywords that will be helpful in discovering and searching for the release.",
"items": {
"type": "string"
}
},
"contact": {
"type": "object",
"description": "Point of contact information for the release.",
"properties": {
"email": {
"type": "string",
"description": "The email address for the point of contact for the release."
},
"name": {
"type": "string",
"description": "The name of the point of contact for the release."
},
"URL": {
"type": "string",
"format": "uri",
"description": "The URL to a website that can be used to reach the point of contact. For example, 'http://twitter.com/codeDotGov'."
},
"phone": {
"type": "string",
"description": "A phone number for the point of contact for the release."
}
},
"additionalProperties": false,
"required": ["email"]
},
"status": {
"type": "string",
"description": "The development status of the release.",
"enum": [
"Ideation",
"Development",
"Alpha",
"Beta",
"Release Candidate",
"Production",
"Archival"
]
},
"vcs": {
"type": "string",
"description": "A lowercase string with the name of the version control system that is being used for the release. For example, 'git'."
},
"repositoryURL": {
"type": "string",
"format": "uri",
"description": "The URL of the public release repository for open source repositories. This field is not required for repositories that are only available as government-wide reuse or are closed (pursuant to one of the exemptions)."
},
"homepageURL": {
"type": "string",
"format": "uri",
"description": "The URL of the public release homepage."
},
"downloadURL": {
"type": "string",
"format": "uri",
"description": "The URL where a distribution of the release can be found."
},
"disclaimerURL": {
"type": "string",
"format": "uri",
"description": "The URL where disclaimer language regarding the release can be found."
},
"disclaimerText": {
"type": "string",
"description": "Short paragraph that includes disclaimer language to accompany the release."
},
"languages": {
"type": "array",
"description": " An array of strings with the names of the programming languages in use on the release.",
"items": {
"type": "string"
}
},
"laborHours": {
"type": "number",
"description": "An estimate of total labor hours spent by your organization/component across all versions of this release. This includes labor performed by federal employees and contractors."
},
"relatedCode": {
"type": "array",
"description": "An array of affiliated government repositories that may be a part of the same project. For example, relatedCode for 'code-gov-front-end' would include 'code-gov-api' and 'code-gov-api-client'.",
"items": {
"type": "object",
"properties": {
"name": {
"type": "string",
"description": "The name of the code repository, project, library or release."
},
"URL": {
"type": "string",
"format": "uri",
"description": "The URL where the code repository, project, library or release can be found."
},
"isGovernmentRepo": {
"type": "boolean",
"description": "True or False. Is the code repository owned or managed by a federal agency?"
}
},
"additionalProperties": false
}
},
"reusedCode": {
"type": "array",
"description": "An array of government source code, libraries, frameworks, APIs, platforms or other software used in this release. For example, US Web Design Standards, cloud.gov, Federalist, Digital Services Playbook, Analytics Reporter.",
"items": {
"type": "object",
"properties": {
"name": {
"type": "string",
"description": "The name of the software used in this release."
},
"URL": {
"type": "string",
"format": "uri",
"description": "The URL where the software can be found."
}
},
"additionalProperties": false
}
},
"partners": {
"type": "array",
"description": "An array of objects including an acronym for each agency partnering on the release and the contact email at such agency.",
"items": {
"type": "object",
"properties": {
"name": {
"type": "string",
"description": "The acronym describing the partner agency."
},
"email": {
"type": "string",
"description": "The email address for the point of contact at the partner agency."
}
},
"additionalProperties": false
}
},
"date": {
"type": "object",
"description": "A date object describing the release.",
"properties": {
"created": {
"type": "string",
"format": "date",
"description": "The date the release was created, in YYYY-MM-DD or ISO 8601 format."
},
"lastModified": {
"type": "string",
"format": "date",
"description": "The date the release was modified, in YYYY-MM-DD or ISO 8601 format."
},
"metadataLastUpdated": {
"type": "string",
"format": "date",
"description": "The date the metadata of the release was last updated, in YYYY-MM-DD or ISO 8601 format."
}
},
"additionalProperties": false
}
},
"required": [
"name",
"permissions",
"repositoryURL",
"description",
"laborHours",
"tags",
"contact"
]
},
"additionalProperties": false
}
},
"required": [
"version",
"measurementType",
"agency",
"releases"
],
"additionalProperties": false
}