Consider adding a worked example of an object that sword works with

[richard-jones]

We have provided an abstract diagram of an object in the specification, but perhaps this would be easier for users to consume if there was a worked example which contained things like:

• The originally deposited Zip files
• Files extracted from the Zip
• Administrative files created by the repo that sword can't touch
• Metadata available in multiple formats

This may be an adjunct to the spec, rather than in the spec itself.

[richard-jones]

We have started a "playbook" which gives us a place to put such worked examples in the future. At the moment it only has a simple example in it, but going forward we should be looking to fill this with real-world type examples of usage.