distribution/doc
Stephen J Day f536633ca8 spec: fetch manifests by tag or digest
Manifests are now fetched by a field called "reference", which may be a tag or
a digest. When using digests to reference a manifest, the data is immutable.
The routes and specification have been updated to allow this.

There are a few caveats to this approach:

1. It may be problematic to rely on data format to differentiate between a tag
   and a digest. Currently, they are disjoint but there may modifications on
   either side that break this guarantee.
2. The caching characteristics of returned content are very different for
   digest versus tag-based references. Digest urls can be cached forever while tag
   urls cannot.

Both of these are minimal caveats that we can live with in the future.

Signed-off-by: Stephen J Day <stephen.day@docker.com>
2015-03-04 21:39:36 -08:00
..
spec spec: fetch manifests by tag or digest 2015-03-04 21:39:36 -08:00
architecture.md Update README and outline documentation 2015-03-02 23:33:02 -08:00
configuration.md Update README and outline documentation 2015-03-02 23:33:02 -08:00
deploying.md Update README and outline documentation 2015-03-02 23:33:02 -08:00
glossary.md Update README and outline documentation 2015-03-02 23:33:02 -08:00
notifications.md Update README and outline documentation 2015-03-02 23:33:02 -08:00
overview.md Update README and outline documentation 2015-03-02 23:33:02 -08:00
storagedrivers.md Update README and outline documentation 2015-03-02 23:33:02 -08:00