Schema: Create generic code.json metadata schema

CONTRIBUTING.md

@@ -13,7 +13,9 @@ We encourage you to read this project's CONTRIBUTING policy (you are here), its
 
 If you would like to comment and provide feedback on the metadata standard, please let us know by filing an **issue on our GitHub repository.**
 
-We are open to adding more fields to CMS code.json for any metadata the agency sees value in collecting. Request new metadata fields by filing a metadata field addition issue [here](https://github.com/DSACMS/gov-codejson/issues/new?template=metadata-field-addition.md).
+We encourage agencies to contribute by submitting a pull request to [include their extended schema in the repository](../schemas). This helps foster collaboration and ensures shared improvements benefit the wider community.
+
+For CMS, we are open to adding more fields to CMS code.json for any metadata the agency sees value in collecting. Request new metadata fields by filing a metadata field addition issue [here](https://github.com/DSACMS/gov-codejson/issues/new?template=metadata-field-addition.md).
 
 ### Team Specific Guidelines
 
@@ -52,7 +54,7 @@ N/A
 
 If you would like to comment on the metadata standard, please let us know by filing an **issue on our GitHub repository.**
 
-We are open to adding more fields to CMS code.json for any metadata the agency sees value in collecting. Request new metadata fields by filing a metadata field addition issue [here](https://github.com/DSACMS/gov-codejson/issues/new?template=metadata-field-addition.md).
+For CMS, we are open to adding more fields to CMS code.json for any metadata the agency sees value in collecting. Request new metadata fields by filing a metadata field addition issue [here](https://github.com/DSACMS/gov-codejson/issues/new?template=metadata-field-addition.md).
 
 ### Writing Pull Requests
 
@@ -102,7 +104,7 @@ Pull requests will be reviewed by the CMS Open Source Program Office team as det
 
 ## Documentation
 
-Refer to [/docs](./docs/) for information about CMS code.json metadata standard.
+Refer to [/docs](./docs/) for information about code.json metadata standard.
 
 ## Policies
 
@@ -122,4 +124,4 @@ For more information about our Security, Vulnerability, and Responsible Disclosu
 
 This project is in the public domain within the United States, and copyright and related rights in the work worldwide are waived through the [CC0 1.0 Universal public domain dedication](https://creativecommons.org/publicdomain/zero/1.0/).
 
-All contributions to this project will be released under the CC0 dedication. By submitting a pull request or issue, you are agreeing to comply with this waiver of copyright interest.
+All contributions to this project will be released under the CC0 dedication. By submitting a pull request or issue, you are agreeing to comply with this waiver of copyright interest.

README.md

@@ -1,15 +1,15 @@
 # gov-codejson
 
-CMS code.json: An agency-wide metadata standard for software projects
+code.json: An agency-wide metadata standard for software projects
 
 ## About the Project
 
-This repository contains documentation on CMS code.json, a metadata standard used to collect information on the agency's software projects in compliance with [M-16-21](https://obamawhitehouse.archives.gov/sites/default/files/omb/memoranda/2016/m_16_21.pdf) and the [SHARE IT Act](https://www.congress.gov/bill/118th-congress/house-bill/9566/text/ih).
+This repository contains documentation on code.json, a metadata standard used to collect information on the agency's software projects in compliance with [M-16-21](https://obamawhitehouse.archives.gov/sites/default/files/omb/memoranda/2016/m_16_21.pdf) and the [SHARE IT Act](https://www.congress.gov/bill/118th-congress/house-bill/9566/text/ih).
 
-- [metadata.md](./docs/metadata.md): Overview on CMS code.json metadata standard
-- [schemas](./schemas): code.json schema
+- [metadata.md](./docs/metadata.md): Overview on code.json metadata standard
+- [schemas](./schemas): code.json generic schema and agency-level schemas
 - [procedures.md](./docs/procedures.md): Procedures and tools on creating and updating metadata
-- [examples.md](./docs/metadata_examples.md): Good examples of metadata in current agency code.json files
+- [examples.md](./docs/examples.md): Good examples of metadata in current agency code.json files
 - [faq.md](./docs/faq.md): Frequently Asked Questions
 
 ### Project Vision
@@ -112,7 +112,7 @@ Information about how the gov-codejson community is governed may be found in [GO
 
 If you would like to comment on the metadata standard, please let us know by filing an **issue on our GitHub repository.**
 
-We are open to adding more fields to CMS code.json for any metadata the agency sees value in collecting. Request new metadata fields by filing a metadata field addition issue [here](https://github.com/DSACMS/gov-codejson/issues/new?template=metadata-field-addition.md).
+We are open to adding more CMS fields to code.json for any metadata the agency sees value in collecting. Request new metadata fields by filing a metadata field addition issue [here](https://github.com/DSACMS/gov-codejson/issues/new?template=metadata-field-addition.md).
 
 If you have ideas for how we can improve or add to our capacity building efforts and methods for welcoming people into our community, please let us know at opensource@cms.hhs.gov.
 
@@ -142,4 +142,4 @@ For more information and resources about SBOMs, visit: https://www.cisa.gov/sbom
 
 This project is in the public domain within the United States, and copyright and related rights in the work worldwide are waived through the [CC0 1.0 Universal public domain dedication](https://creativecommons.org/publicdomain/zero/1.0/) as indicated in [LICENSE](LICENSE).
 
-All contributions to this project will be released under the CC0 dedication. By submitting a pull request or issue, you are agreeing to comply with this waiver of copyright interest.
+All contributions to this project will be released under the CC0 dedication. By submitting a pull request or issue, you are agreeing to comply with this waiver of copyright interest.

code.json

@@ -1,7 +1,7 @@
 {
   "name": "gov-codejson",
-  "description": "CMS code.json: An agency-wide metadata standard for software projects",
-  "longDescription": "This repository contains documentation on CMS code.json, a metadata standard used to collect information on the agency's software projects in compliance with M-16-21 and the SHARE IT Act.",
+  "description": "code.json: An agency-wide metadata standard for software projects",
+  "longDescription": "This repository contains documentation on code.json, a metadata standard used to collect information on the agency's software projects in compliance with M-16-21 and the SHARE IT Act.",
   "status": "Production",
   "permissions": {
     "license": [
@@ -17,17 +17,31 @@
   "repositoryURL": "https://github.com/DSACMS/gov-codejson",
   "vcs": "git",
   "laborHours": 3479,
-  "platforms": ["web"],
-  "categories": ["knowledge-management", "help-desk"],
+  "platforms": [
+    "web"
+  ],
+  "categories": [
+    "knowledge-management",
+    "help-desk"
+  ],
   "softwareType": "standalone/web",
-  "languages": ["Markdown"],
+  "languages": [
+    "Markdown"
+  ],
   "maintenance": "internal",
   "date": {
     "created": "2025-02-04T21:59:53Z",
     "lastModified": "2025-02-11T18:45:30Z",
     "metaDataLastUpdated": "2025-02-11T18:47:02.924Z"
   },
-  "tags": ["guide", "codejson", "OSPO", "metadata", "SHAREIT", "M-16-21"],
+  "tags": [
+    "guide",
+    "codejson",
+    "OSPO",
+    "metadata",
+    "SHAREIT",
+    "M-16-21"
+  ],
   "contact": {
     "email": "opensource@cms.hhs.gov",
     "name": "CMS Open Source Team"
@@ -37,8 +51,12 @@
   "userInput": false,
   "fismaLevel": "Low",
   "group": "CMS/OA/DSAC",
-  "subsetInHealthcare": ["Operational"],
-  "userType": ["Government"],
+  "subsetInHealthcare": [
+    "Operational"
+  ],
+  "userType": [
+    "Government"
+  ],
   "repositoryHost": "github.com/DSACMS",
   "maturityModelTier": 3
-}
+}

docs/faq.md

@@ -52,8 +52,14 @@ By collecting metadata on every software project, this allows the agency to buil
 
 ### Is code.json mandatory for all repositories?
 
-Yes. As per M-16-21 and the SHARE IT Act, agencies are required to publish metadata on all custom-developed code after August 8th 2016, which is not subject to exemptions (see: Sec 6 of [M-16-21](https://obamawhitehouse.archives.gov/sites/default/files/omb/memoranda/2016/m_16_21.pdf) and <a target="_blank" href="https://www.congress.gov/bill/118th-congress/house-bill/9566/text/ih#HB45699B7E8734166BE2F6DA2A80F7909">SHARE IT ACT exemptions</a>)
+Yes. As per M-16-21, agencies are required to publish metadata on all custom-developed code after August 8th 2016, which is not subject to exemptions (see: Sec 6 of [M-16-21](https://obamawhitehouse.archives.gov/sites/default/files/omb/memoranda/2016/m_16_21.pdf)).
+
+As per the SHARE IT Act, agencies are required to publish metadata on all custom-developed code after July 22, 2025, which is not subject to exemptions (see: [SHARE IT ACT exemptions](https://www.congress.gov/118/plaws/publ187/PLAW-118publ187.pdf)).
 
 ### I have feedback on additions and improvements to the code.json metadata standard. Where can I share this?
 
 We are open to adding more fields to CMS code.json for any metadata the agency sees value in collecting. Request new metadata fields by filing a metadata field addition issue [here](https://github.com/DSACMS/gov-codejson/issues/new?template=metadata-field-addition.md).
+
+### My agency extended the code.json schema to add more metadata fields. Where can I share this?
+
+We encourage agencies to contribute by submitting a pull request to [include their extended schema in the repository](../schemas). This helps foster collaboration and ensures shared improvements benefit the wider community.

docs/metadata.md

@@ -1,14 +1,23 @@
 # Code.json
 
-CMS `code.json` is a metadata standard created to collect information on the agency's software projects. This is composed of:
+`code.json` is a metadata standard created to collect information on the agency's software projects. This is composed of:
 
 - federal code.json standard, created as part of [M-16-21](https://obamawhitehouse.archives.gov/sites/default/files/omb/memoranda/2016/m_16_21.pdf)
-- metadata CMS would like to collect (e.g. FISMA level, repository host, group)
 - required metadata outlined in the [SHARE IT ACT](https://www.congress.gov/bill/118th-congress/house-bill/9566/text/ih) (e.g. repository visibility, contract number)
 - publiccode.yml metadata, an international metadata standard
 
 By harmonizing various standards, this opens up the opportunity to share our work not just on an agency level but also on a national and international level.
 
+The generic code.json schema can be found in the [`schemas` directory](../schemas/schema.1.0.0.json).
+
+### Extending the schema for agency use
+
+The generic schema is designed to be extensible, allowing agencies to add metadata fields that are relevant to their specific needs.
+
+For example, CMS has their [own schema](../schemas/cms/) that includes new fields such as FISMA level, subset in healthcare, and systems.
+
+We encourage agencies to contribute by submitting a pull request to [include their extended schema in the repository](../schemas). This helps foster collaboration and ensures shared improvements benefit the wider community.
+
 ### Fields
 
 **Legend**
@@ -443,4 +452,4 @@ Full schema can be found in [schema-0.1.0.json](../schemas/schema-0.1.0.json).
 
 ### Adding new metadata fields
 
-We are open to adding more fields to CMS code.json for any metadata the agency sees value in collecting. Request new metadata fields by filing a metadata field addition issue [here](https://github.com/DSACMS/gov-codejson/issues/new?template=metadata-field-addition.md).
+For CMS, we are open to adding more fields to CMS code.json for any metadata the agency sees value in collecting. Request new metadata fields by filing a metadata field addition issue [here](https://github.com/DSACMS/gov-codejson/issues/new?template=metadata-field-addition.md).