The Common Education Data Standards (CEDS) are an education data management initiative whose purpose is to streamline the understanding of data within and across P-20W institutions and sectors. CEDS includes a common vocabulary complete with standard elements names, definitions, and option sets. This repository contains all the CEDS elements, definitions, option sets and their definitions, and entities and definitions. Its purpose is to expand that vocabulary to meet the needs of every education stakeholder. The expanded vocabulary is then added to the CEDS Integration Data Store and CEDS Data Warehouse – the other two repositories located here.
This is for capturing needs not currently supported by the CEDS model. Please do not send or share actual data as examples in this issue or in attachments.
Author(s): CJ Gilbert; Kristy Webber
Authoring Organization(s): State of Michigan/CEPI
Email address: gilbertc6@michigan.gov
Use Case Title: Add element to store SEA/Local Usage Notes
Use Case Description
Element name: Local Usage Notes
Element Definition: State-specific usage and/or governance details designated by the SEA as essential to understanding and using this element or option correctly.
Usage note: Organizations may use this field to hyperlink to data governance documentation for the specific element and/or option.
Date Type: Alphanumeric, length 512
Use Case Background
CEDS reference tables come prepopulated with all of the CEDS options as well as the CEDS definitions or descriptions for those options.
In some cases, the definitions/descriptions are so vague or ambiguous that they provide users with no additional context to help understand the option.
In other cases, the definition is clear, but there is state-specific context that would be useful to include within the Ref table so that future developers and analysts exploring the data will see that context.
We propose adding an implementation variable element to hold Local Usage Notes. An example of how this would be useful: when an element’s definition says “as defined by the state,” the Local Usage Notes element would allow the SEA to enrich the CEDS definition with state-specific details in the Ref table.
We suggest making this an alphanumeric field with length 512 to allow organizations to make critical governance/usage details available within the Ref tables (decreasing the likelihood of such information being 'lost' over time). Alternatively, this field could be used by organizations to put in a hyperlink pointing to where more detailed governance/usage documentation is kept.
Location of Element in the Domain Entity Schema
Implementation Variables
gilbertcj6
commented
1 week ago
This is for capturing needs not currently supported by the CEDS model. Please do not send or share actual data as examples in this issue or in attachments.
Author(s): CJ Gilbert; Kristy Webber
Authoring Organization(s): State of Michigan/CEPI
Email address: gilbertc6@michigan.gov
Use Case Title: Add element to store SEA/Local Usage Notes
Use Case Description
Element name: Local Usage Notes
Element Definition: State-specific usage and/or governance details designated by the SEA as essential to understanding and using this element or option correctly.
Usage note: Organizations may use this field to hyperlink to data governance documentation for the specific element and/or option.
Date Type: Alphanumeric, length 512
Use Case Background
CEDS reference tables come prepopulated with all of the CEDS options as well as the CEDS definitions or descriptions for those options.
In some cases, the definitions/descriptions are so vague or ambiguous that they provide users with no additional context to help understand the option.
In other cases, the definition is clear, but there is state-specific context that would be useful to include within the Ref table so that future developers and analysts exploring the data will see that context.
We propose adding an implementation variable element to hold Local Usage Notes. An example of how this would be useful: when an element’s definition says “as defined by the state,” the Local Usage Notes element would allow the SEA to enrich the CEDS definition with state-specific details in the Ref table.
We suggest making this an alphanumeric field with length 512 to allow organizations to make critical governance/usage details available within the Ref tables (decreasing the likelihood of such information being 'lost' over time). Alternatively, this field could be used by organizations to put in a hyperlink pointing to where more detailed governance/usage documentation is kept.
Location of Element in the Domain Entity Schema Implementation Variables