Code-dot-mil / Code-dot-mil/code.mil

Add FAQ item for git history and records retention

Aperta
#144 2 commenti 0 reazioni 1 assegnatario Rivendicata da @shawoods Vedi su GitHub
[issue-type] policy FAQ
Lingua principale
JavaScript
Stelle
1.3k
Fork
144
Metriche di merge delle PR
Nessuna PR unita negli ultimi 30g

Descrizione

This is the guidance coming out of #67 on FOIA, records retention, and git history rewrites. This language needs a little review, but I'm generally in favor of it.

@shawoods: can you review?

----

# A note on `git` features and rewriting history

The `git` program and hosted services such as GitHub include the ability for you to permanently delete parts of your project. They also allow you to "rewrite history" in that you may modify entries that have been previously published. Examples include:

* [Deleting a branch](https://git-scm.com/book/en/v2/Git-Branching-Branch-Management) that has not been merged into a surviving branch
* [Merging a branch](https://git-scm.com/docs/git-merge) using the `--squash` feature
* [Using `git push`](https://git-scm.com/docs/git-push) with the `--force` feature

Code.mil is aware of records keeping laws in [18 U.S.C. 2257](https://www.gpo.gov/fdsys/granule/USCODE-2011-title18/USCODE-2011-title18-partI-chap110-sec2257). We have not studied these laws nor are we aware of any case law that prescribes whether records keeping requirements pertain to portions of your `git` repository. Additionally, we do not know about YOUR agency's data backup systems. When you use the three deletion/rewriting abilities above the old file versions may still be persisted on your computer (see `git` [garbage collection](https://git-scm.com/docs/git-gc)) and captured by these data backup systems.

In summary, `git` is a powerful tool so make sure you understand it before you use it. Your agency may prescribe additional guidelines or restrictions for using `git`. However, code.mil has no advice to offer on setting such guidelines or restrictions.

Guida per i contributori

Apri la guida per i contributori

Valutazione

Questa issue non è ancora stata valutata.

Ricevi le nuove issue nella tua casella

Un breve riepilogo di issue GitHub adatte ai principianti.