Skip to content
Merged
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
22 changes: 19 additions & 3 deletions content/outbound/archiving-repositories.md
Original file line number Diff line number Diff line change
Expand Up @@ -27,7 +27,10 @@ _Based on TODOgroup's guide: <br /> [https://github.com/todogroup/guides/blob/ma
- Project performance metrics (e.g. participation, usage, adoption, updates) are declining based on your latest user data
- Maintenance status has changed (e.g. code is no longer being patched or updated by the community to resolve vulnerabilities)

# Repository Archival Checklist
# Repository Archival Checklists
To prepare a repository for archival, complete the tasks below to perform a thorough review of the repository.

_A complete list of all tasks described below are complied in checklists found [here](https://github.com/DSACMS/repo-sunsetter/tree/main/checklists)._

## For all tiers

Expand All @@ -46,7 +49,7 @@ Enabling `archived` mode in the [automated-codejson-generator GitHub Action](htt
Repository Documentation can provide explicit statements about the status of a project or community. Communicating clearly, whether the project is active or inactive, is important.

#### Update Repository Documentation
- [ ] Clearly state at the top the README that the project has been deprecated and will no longer be updated. If possible, suggest alternate projects that provide similar functionality.
- [ ] Clearly state at the top of the README that the project has been deprecated and will no longer be updated. If possible, suggest alternate projects that provide similar functionality.
- Sample Text:
> "This project is now archived and no longer actively maintained. It has been archived to retain its contents for reference. Feel free to explore and fork the repository, but please note that updates or support will not be provided."

Expand All @@ -63,7 +66,9 @@ Repository Issues serve as a type of record of the decision making processes of
- [ ] Review committer access

#### Perform a lightweight security review
- [ ] Review for secrets, keys, PII
- [ ] Review repository for secrets and keys
- [ ] Check for any Personal Identifiable Information (PII)
- [ ] Remove or redact any sensitive information found

### Other
- [ ] Delete inactive branches
Expand Down Expand Up @@ -102,6 +107,14 @@ Repository Pull Requests serve as a type of record of the decision making proces
- [ ] Ensure CHANGELOG.md outlines completed work and the project's final state
- [ ] Review releases and tags (if applicable, Maturity Model Tier3+)

## repo-sunsetter
Comment thread
decause-gov marked this conversation as resolved.
repo-sunsetter is a repository-level GitHub Action developed by the OSPO to prepare repositories for archival. It implements the work described above by:
1. Adds an archival notice to the README.md to inform users about the state of the repository
2. Updates project metadata by marking project as archived in code.json
3. Files an issue containing the archival checklist based on the repository's maturity model tier.

For more information on using this action for your team's / organization's repository, visit the [repo-sunsetter repository](https://github.com/DSACMS/repo-sunsetter).

## Archiving a repository on DSACMS GitHub

_Based on_ [https://docs.github.com/en/repositories/archiving-a-github-repository/archiving-repositories#archiving-a-repository](https://docs.github.com/en/repositories/archiving-a-github-repository/archiving-repositories#archiving-a-repository)
Expand All @@ -125,3 +138,6 @@ Submit a request to the [CMS Web Help Service Desk:](https://jira.cms.gov/servic

Submit a request to the [CMS Enterprise Agile Tools Service Desk:](https://jiraent.cms.gov/servicedesk/customer/portal/4)
[https://jiraent.cms.gov/servicedesk/customer/portal/4/create/183](https://jiraent.cms.gov/servicedesk/customer/portal/4/create/183)

## Resources
[Practitioner Guide: Getting Started with Sunsetting an Open Source Project by CHAOSS](https://chaoss.community/practitioner-guide-sunset/)
Loading