Arvados

The examples in the Python SDK cookbook are good illustrations of common tasks, but there isn't much in there to help the reader understand why the code is structured the way it is, or how they might adapt the code to their particular use case. Expand the cookbook to improve this situation.

• Organize the recipes into related sections.
• Add a preface to each recipe to detail what it does and give a use case for when you might want it.
• Add comments to the code to explain tricky parts or suggest how to make common changes.
• Structure the code to prioritize follow-ability. Use variable names that are as self-documenting as possible. Avoid doing multiple things on one line of code.