-
Notifications
You must be signed in to change notification settings - Fork 5
Maintenance Meeting Schedule
Draft for discussion and revision by the DCAT Interagency Maintenance Team and the Data.gov team.
This page describes the proposed meeting schedule for operating the DCAT-US v3.0 maintenance process.
The maintenance meeting structure is intended to support:
- Continuous issue triage
- Semi-annual schema review
- Release planning
- Agency feedback
- Documentation coordination
- Release communications
- Annual retrospective review
- Follow-up tracking
The DCAT Interagency Maintenance Team governs schema maintenance decisions. The Data.gov team at GSA maintains the DCAT-US repository and coordinates the maintenance cycle.
| Meeting | Cadence | Primary Audience | Purpose |
|---|---|---|---|
| Continuous Issue Triage | Bi-weekly or monthly | Data.gov team | Review, label, and route new issues |
| Pre-Cycle Planning | Twice per year | Data.gov team + DCAT Interagency Maintenance Team leads | Prepare milestone issues for review |
| DCAT Interagency Maintenance Team Schema Review | Twice per year | DCAT Interagency Maintenance Team + Data.gov team | Review prioritized issues and assign dispositions |
| Agency Feedback Meeting | As needed, likely once or twice per release cycle | Selected agencies + Data.gov team + Maintenance Team representatives | Gather implementation impact feedback |
| Release Readiness Meeting | Twice per year | Data.gov team + Maintenance Team representative | Confirm PRs, documentation, release notes, and outreach readiness |
| Post-Release Outreach | Twice per year | Agencies, Data.gov team, Maintenance Team representatives | Share release changes and answer agency questions |
| Annual Retrospective | Annually in July | DCAT Interagency Maintenance Team, Data.gov team, selected agencies | Review validation trends, lessons learned, and priorities for the next cycle |
The following calendar provides a suggested annual operating rhythm for DCAT-US v3.0 maintenance.
| Month | Activity |
|---|---|
| Ongoing | Continuous issue triage within two weeks of issue submission |
| January | Cycle 1 pre-cycle planning and milestone review |
| February | Cycle 1 DCAT Interagency Maintenance Team schema review |
| February/March | Agency feedback meeting, if needed |
| March | Cycle 1 release readiness meeting |
| March/April | Spring release, release notes, and outreach |
| April/May | Monitor agency questions and implementation feedback |
| May | Cycle 2 pre-cycle planning and milestone review |
| June | Cycle 2 DCAT Interagency Maintenance Team schema review |
| June | Agency feedback meeting, if needed |
| Late June/July | Cycle 2 release readiness meeting |
| July | Summer release aligned with the M-25-05 annual compliance reference date |
| July | Annual retrospective |
| August | Share compliance support summary and next-cycle priorities, if applicable |
| September–December | Continue triage, documentation updates, issue review, and implementation support |
The Continuous Issue Triage Meeting supports rolling review of new DCAT-US GitHub issues and related items submitted through other channels.
Issues are triaged as they are submitted, rather than batched to a specific time of year.
The Data.gov team applies a classification label to each new issue within two weeks of submission.
Suggested cadence:
- Bi-weekly if issue volume is high
- Monthly if issue volume is low
- Asynchronous triage with a monthly checkpoint if issue volume is minimal
Suggested duration:
- 30 minutes
Recommended participants include:
- Data.gov product or program lead
- DCAT-US repository maintainer
- Data.gov technical representative
- Documentation representative, if applicable
- Schema team representative, if applicable
A typical Continuous Issue Triage Meeting may include:
- Review new GitHub issues submitted since the last triage
- Review issues received through Zendesk, Data.gov Help, CDO Council channels, office hours, or other channels
- Apply classification labels:
bugenhancementquestion
- Determine whether each issue is:
- Schema-related
- Documentation-related
- Implementation guidance-related
- Harvesting-related
- Data.gov product-related
- Out of scope
- Assign issues to milestones, if appropriate
- Identify issues needing DCAT Interagency Maintenance Team review
- Identify time-sensitive issues
- Identify issues that need more information
- Route issues to other processes, if needed
Expected outputs include:
- New issues labeled
- Issues routed to the appropriate process
- Issues assigned to milestones, if appropriate
- Issues needing more information identified
- Issues requiring DCAT Interagency Maintenance Team review identified
- Out-of-scope issues closed or redirected
- Follow-up actions assigned
The Pre-Cycle Planning Meeting prepares for an upcoming maintenance release cycle.
This meeting is used to review candidate issues, confirm release scope, identify documentation work, and prepare materials for DCAT Interagency Maintenance Team review.
Twice per year:
- Cycle 1 pre-cycle planning in January or early February
- Cycle 2 pre-cycle planning in May or early June
Suggested duration:
- 50 minutes
Recommended participants include:
- Data.gov team
- DCAT Interagency Maintenance Team leads or designated representatives
- DCAT-US repository maintainer
- Schema team representative
- Documentation lead
- Communications or outreach representative, if applicable
A typical Pre-Cycle Planning Meeting may include:
- Confirm the upcoming release cycle and target timeline
- Review issues assigned to the upcoming cycle milestone
- Identify candidate issues for Maintenance Team discussion
- Identify likely non-breaking changes
- Identify potential breaking changes
- Identify documentation issues needing resolution
- Identify issues requiring agency feedback
- Identify issues requiring security considerations notes
- Confirm whether any changes may affect:
accessRestrictionuseRestrictioncuiRestriction
- Confirm draft agenda for the Maintenance Team schema review
- Assign preparation tasks and owners
Expected outputs include:
- Draft issue review agenda
- Candidate release scope
- List of issues requiring Maintenance Team review
- List of issues requiring agency feedback
- Documentation worklist
- Security considerations flags, if applicable
- Proposed release timeline
- Assigned preparation tasks
The DCAT Interagency Maintenance Team Schema Review is the primary governance meeting for reviewing prioritized DCAT-US v3.0 maintenance issues.
During this meeting, the DCAT Interagency Maintenance Team reviews issues in the relevant release cycle milestone and assigns dispositions.
Twice per year:
- Cycle 1 schema review in February
- Cycle 2 schema review in June
Suggested duration:
- 60 minutes for a standard review
- 90 minutes if there are multiple high-impact issues or potential breaking changes
Recommended participants include:
- DCAT Interagency Maintenance Team members
- Data.gov team
- DCAT-US repository maintainer
- Schema team representative
- Documentation representative
- Invited agency subject matter experts, if needed
A typical Schema Review Meeting may include:
- Welcome and meeting objectives
- Review release cycle timeline
- Review issue disposition options
- Review prioritized milestone issues
- For each issue, discuss:
- Issue summary
- Issue type
- Affected field or schema area
- Implementation impact
- Validation impact
- Documentation impact
- Whether the change is breaking or non-breaking
- Whether agency feedback is needed
- Whether a deprecation notice is needed
- Assign disposition to each reviewed issue
- Confirm approved PR list
- Confirm deferred issue list
- Confirm documentation-only issues
- Confirm issues needing more information
- Confirm follow-up actions
The DCAT Interagency Maintenance Team may assign one of the following dispositions:
| Disposition | Meaning |
|---|---|
| Approved for PR | The issue should move forward as a pull request |
| Deferred | The issue should be reconsidered in a future cycle |
| Closed as won’t fix | The issue will not be addressed through a schema or documentation change |
| Needs more information | Additional information is needed before a decision can be made |
| Documentation update only | The issue should be addressed through documentation, examples, FAQs, or guidance rather than a schema change |
Expected outputs include:
- Disposition assigned to each reviewed issue
- Approved PR list
- Deferred issue list
- Closed issue list
- Documentation update list
- Issues needing more information
- Issues requiring agency feedback
- Deprecation notice list, if applicable
- Follow-up actions and owners
Agency Feedback Meetings provide an opportunity to gather practical implementation feedback from selected agencies before final maintenance decisions are made.
These meetings are especially useful when proposed changes may affect agency metadata workflows, validation behavior, harvesting, documentation, or existing data.json implementations.
As needed.
Suggested timing:
| Timing | Purpose |
|---|---|
| February or March | Gather feedback on Cycle 1 issues, proposed clarifications, or deprecation notices |
| June | Gather feedback on Cycle 2 issues, eligible breaking changes, migration guidance, or retrospective topics |
| July | Support annual retrospective discussion, if needed |
Agency feedback meetings may not be needed for every release cycle.
Suggested duration:
- 50 minutes for standard feedback discussions
- 60–90 minutes for multiple high-impact issues or retrospective feedback
Recommended participants include:
- Selected agency metadata or data inventory leads
- Selected agency technical implementation leads
- Selected agency policy or data governance representatives
- Data.gov team members
- DCAT Interagency Maintenance Team representatives
- Documentation contributors, if relevant
- Schema team representatives, if relevant
Agencies may be invited based on:
- Active DCAT-US 3 implementation work
- High-volume Data.gov publishing
- Complex or specialized metadata
- Different metadata management approaches
- Active harvest source transitions
- Relevant implementation experience with the issue under review
- Validation or harvesting patterns relevant to the issue under review
A typical Agency Feedback Meeting may include:
- Welcome and purpose
- Review issue or topic being discussed
- Explain maintenance context and release cycle timing
- Present proposed change, clarification, or deprecation notice
- Discuss agency implementation impacts
- Discuss validation, harvesting, or display considerations
- Identify documentation or guidance needs
- Identify risks, blockers, or timing concerns
- Summarize feedback
- Confirm follow-up actions
Expected outputs include:
- Agency feedback summary
- Implementation impact notes
- Documentation recommendations
- FAQ topics
- Migration guidance needs
- Examples or edge cases
- Risks or blockers
- Issues requiring additional review
- Recommendations for Maintenance Team consideration
The Release Readiness Meeting confirms that approved changes, documentation updates, release notes, changelog entries, and outreach materials are ready before a release is tagged and communicated.
Twice per year:
- Cycle 1 release readiness in March
- Cycle 2 release readiness in late June or early July
Suggested duration:
- 50 minutes
Recommended participants include:
- Data.gov team
- DCAT-US repository maintainer
- Schema team representative
- Documentation lead
- DCAT Interagency Maintenance Team representative
- Communications or outreach representative, if applicable
A typical Release Readiness Meeting may include:
- Confirm target release date
- Review approved pull requests
- Confirm PRs are ready to merge
- Confirm documentation updates are complete or tracked
- Confirm examples have been validated
- Confirm changelog entry is drafted
- Confirm GitHub release notes are drafted
- Confirm whether
conformsToURI requires updating - Confirm security considerations notes are included, if applicable
- Confirm deprecation notices are included, if applicable
- Confirm 90-day grace period language is included, if applicable
- Confirm agency outreach message is ready
- Confirm post-release support plan
- Confirm release decision
- Issues assigned to the cycle milestone have been reviewed.
- Issue dispositions have been documented.
- Approved pull requests are ready to merge.
- Breaking changes have received prior deprecation notice, if applicable.
- Minimum 90-day agency implementation window has been considered, if applicable.
- Security considerations notes are included for changes touching:
-
accessRestriction -
useRestriction -
cuiRestriction
-
- Documentation updates are complete or tracked.
- Example records have been validated against the current schema.
- Changelog entry is drafted.
- GitHub release notes are drafted.
-
conformsToURI update decision has been confirmed. - Agency outreach message is drafted.
- Grace period language is included, if applicable.
- Deprecation notice language is included, if applicable.
Expected outputs include:
- Release readiness decision
- Final PR merge list
- Final documentation checklist
- Changelog text
- GitHub release notes
- Outreach message
- Deprecation notices, if applicable
- Grace period language, if applicable
- Confirmed release date
- Post-release follow-up plan
Post-Release Outreach communicates release changes to agencies and provides a forum for implementation questions.
Outreach may occur through GitHub release notes, CDO Council channels, the Data.gov mailing list, DCAT Interagency Info Sharing Sessions, CDO Council touchpoints, or other appropriate channels.
Twice per year:
- After Cycle 1 spring release
- After Cycle 2 summer release
Release notes should be published within two weeks of the release tag.
A discussion or presentation may occur within two to four weeks after the release, if needed.
Recommended participants may include:
- Data.gov team
- DCAT Interagency Maintenance Team representatives
- Agency metadata or data inventory leads
- Agency technical implementation leads
- CDO Council representatives
- Documentation contributors, if needed
Post-release outreach may include:
- Release version and date
- Summary of changes
- Schema updates
- Documentation updates
- Bug fixes
- Enhancements
- Clarifications
- Deprecation notices
- Grace period information
- Migration guidance, if applicable
- Recommended agency actions
- Where to ask questions
- Where to submit GitHub issues
Expected outputs include:
- Release notes published
- Outreach message sent
- Agency questions captured
- Follow-up issues filed, if needed
- FAQ updates identified
- Implementation blockers documented
- Office hours topics identified
- Info Sharing Session topics identified
The Annual Retrospective Meeting reviews implementation experience, validation trends, documentation gaps, agency blockers, release process lessons learned, and priorities for the next annual maintenance cycle.
The retrospective is an implementation support activity and is not an enforcement activity.
Annually.
July, as part of Cycle 2.
Suggested duration:
- 60–90 minutes
Recommended participants include:
- DCAT Interagency Maintenance Team members
- Data.gov team members
- Schema team representatives
- Documentation contributors
- Selected agency representatives
- Agency metadata or data inventory leads
- Agency technical implementation leads
- Agency policy or data governance representatives
- Data.gov analytics or monitoring representatives familiar with New Relic data
- Harvesting or validation subject matter experts
A typical Annual Retrospective Meeting may include:
- Welcome and objectives
- Review of the maintenance year
- Review Cycle 1 release activities
- Review Cycle 2 release activities
- Review harvest validation error trends
- Review New Relic data
- Identify systemic field-level error patterns
- Review GitHub issue trends
- Review agency feedback and blockers
- Review documentation and guidance gaps
- Review release communications and outreach
- Discuss annual compliance support summary
- Identify lessons learned
- Identify priorities for next annual cycle
- Confirm follow-up actions and owners
Expected outputs include:
- Annual retrospective notes
- Annual compliance support summary
- List of systemic validation or implementation issues
- GitHub issues filed for schema clarification or guidance updates
- Documentation update tasks
- FAQ update tasks
- Recommended agency support activities
- Lessons learned
- Priorities for the next annual maintenance cycle
- Updates to maintenance process documentation, if needed
The maintenance meetings are separate from, but connected to, existing DCAT interagency engagement forums.
Office hours may surface:
- Field interpretation questions
- Validation issues
- Implementation blockers
- Recurring agency questions
- Potential FAQ topics
- Issues that should be filed in GitHub
Office hours are not a formal maintenance governance meeting, but issues raised there may feed into the maintenance process.
The monthly information sharing session may be used to:
- Share release updates
- Present proposed changes
- Demonstrate updated guidance
- Discuss implementation patterns
- Gather high-level agency feedback
- Identify agencies interested in deeper maintenance participation
CDO Council touchpoints may be used to:
- Communicate release notes
- Share deprecation notices
- Discuss broader implementation impacts
- Gather agency feedback on major proposed changes
- Support awareness of annual retrospective findings
For the first year of the maintenance process, the meeting structure may be treated as a pilot.
The first-year meeting pilot should help determine:
- Whether the meeting cadence is appropriate
- Whether issue triage within two weeks is feasible
- Whether schema review meetings have enough time
- Whether agency feedback meetings are useful
- Whether release readiness meetings reduce release risk
- Whether outreach meetings help agencies understand changes
- Whether the retrospective identifies useful next-cycle priorities
| Timeframe | Meeting |
|---|---|
| Ongoing | Continuous Issue Triage |
| January or early February | Cycle 1 Pre-Cycle Planning |
| February | Cycle 1 Schema Review |
| February or March | Cycle 1 Agency Feedback Meeting, if needed |
| March | Cycle 1 Release Readiness |
| March/April | Cycle 1 Post-Release Outreach |
| May or early June | Cycle 2 Pre-Cycle Planning |
| June | Cycle 2 Schema Review |
| June | Cycle 2 Agency Feedback Meeting, if needed |
| Late June or July | Cycle 2 Release Readiness |
| July | Cycle 2 Post-Release Outreach |
| July | Annual Retrospective |
Each maintenance meeting should have enough documentation to support transparency and follow-up.
Meeting documentation may include:
- Agenda
- Attendees
- Issues reviewed
- Decisions or dispositions
- Follow-up actions
- Owners
- Due dates
- Links to GitHub issues
- Links to pull requests
- Links to documentation updates
- Links to release notes
- Notes on agency feedback or implementation impacts
The following structure may be used for meeting notes.
# Meeting Notes
## Meeting Name
## Date
## Participants
## Purpose
## Agenda
## Issues or Topics Reviewed
## Decisions
## Follow-Up Actions
| Action | Owner | Due Date | Status |
|---|---|---|---|
## Related Links
- GitHub issues:
- Pull requests:
- Documentation:
- Release notes:
- Meeting materials:https://github.com/GSA/dcat-us/issues
Use this issue tracker to request or discuss changes to the DCAT-US metadata standard itself.
https://github.com/GSA/dcat-us
Repository for the DCAT-US metadata standard.
https://resources.data.gov/resources/dcat-us-3-implementation/
Primary reference for agencies implementing the DCAT-US 3 metadata standard.
https://github.com/GSA/dcat-us/wiki/DCAT-US-3-Technical-Implementation-FAQ
Frequently asked questions related to technical implementation of the DCAT-US 3 metadata standard are posted here as they are developed.
https://resources.data.gov/resources/dcat-us-3-updates/
Use this page for meeting schedule updates and related DCAT-US 3 engagement information.
Questions about Data.gov harvesting or resources.data.gov documentation can be directed to:
- DCAT-US 3 Implementation Resources
- Agency Workflow for DCAT-US 3 Harvest Source Requests
- Inventory.data.gov Access
- Harvest Source Review and Validation
- Harvest Source Change Requests
- FAQ Overview
- DCAT-US 3 Technical Implementation FAQ
- Harvest Source Request FAQ
- Inventory.data.gov Access FAQ
- Meeting FAQ
- Tracking and Issue Routing FAQ
- DCAT Interagency Maintenance Team
- DCAT IMT CHARTER
- Maintenance Process Overview
- Roles and Responsibilities
- Issue Triage and GitHub Workflow
- Semi-Annual Release Cycles
- Agency Feedback and Participation
- Release Communications and Outreach
- Annual Retrospective
- Maintenance Meeting Schedule
- Maintenance Templates