Skip to content
Permalink

Comparing changes

Choose two branches to see what’s changed or to start a new pull request. If you need to, you can also or learn more about diff comparisons.

Open a pull request

Create a new pull request by comparing changes across two branches. If you need to, you can also . Learn more about diff comparisons here.
base repository: GlasgowEmbedded/archive
Failed to load repositories. Confirm that selected base ref is valid, then try again.
Loading
base: 2fbd6b1b91cc
Choose a base ref
...
head repository: GlasgowEmbedded/archive
Failed to load repositories. Confirm that selected head ref is valid, then try again.
Loading
compare: e184cfb007f4
Choose a head ref

There isn’t anything to compare.

2fbd6b1b91cc and e184cfb007f4 are entirely different commit histories.

Showing with 24 additions and 0 deletions.
  1. +24 −0 README.md
24 changes: 24 additions & 0 deletions README.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,24 @@
# Glasgow Archive

This repository contains a permanent archive of all vendor documentation used when implementing
the Glasgow protocols, applets, architecture information, and databases.

## Organization

The archive uses a flat structure where each document is assigned a sequential accession number,
in the format `G00000`. Then, the document is renamed to have the same filename as its full title
and revision, and placed in the directory with the same name as the accession number, for example,
`G00001/Vendor® Protocol™ Rev 1.03.pdf`. If a newer revision of the same document is later
archived, a sequential letter suffix is added to the accession number, in the format `G00000A`.
This ensures an exact 1:1 correspondence between numbers and documents.

## Licensing

Vendor documentation is never permissively licensed and often can't be redistributed at all.
Therefore, this repository should *never* be redistributed as a part of Glasgow itself. Similarly,
it is a separate repository to avoid availability issues in case of a takedown notice.

The archive nevertheless has the goal of redistributing all documentation that was used during
development of Glasgow. Vendors are, in general, incompetent, and cannot be trusted to do anything
right, especially making their documentation available. We have to do that ourselves, often in
an adversarial way. That is just the unfortunate fact of life.