Gunnar Gissel

I'll answer one question - if you include `Accept: application/json` in the request header you'll get json

I'll answer my other question - nextLink, deltaLink and delta are not supported currently. But they look pretty straightforward to add, let's see if I can make an acceptable PR

The documentation definitely needs work, particularly around tutorials and recipes. In this case, here's an example op that passes a file in: ```yaml name: example description: an example op inputs:...

Rephrasing the policy as a vision: Opctl should have documentation that makes it easy for beginners to pick it up up, and experienced devs to quickly answer questions. To serve...

The way I think of that is that a given documentation type has a primary audience. It may have secondary, or even tertiary audiences, but when reviewing the writing you...

I'd say given a policy, it would suggest things like "adopt a template for document types" and "make a checklist for document prs". I really like the idea of trainings...

I think I'd be happy just deciding on the direction we want to take the training docs. `Alternatively, refactor the “Training” documentation to be a manual with a tutorial cookbook.`...

The specific deliverable I want out of the proposal to refactor the documentation is a direction + a number of issues that can be assigned/tracked, so we can distribute making...