Update README and add docker example (mainly as a base for reproducing issues) #461
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
Having reviewed current issues, and considered questions raised elsewhere, I feel that we need to provide more information to assist those starting out with the library and those experiencing issues (particularly in regards to the level of information needed when raising an issue).
This pull request significantly updates/enhances the
readme.md
and addscmd/docker
(which should be a useful example as well as providing a good base for those wanting to produce a reproducible example of an issue). Note: I considered renamingcmd
toexamples
to make it more discoverable but have left it as-is for now.A key aim of this change is to provide something that can be referred to when replying to issues that provide insufficient information (removing the need to copy/paste from, or provide links to, other issues).