2U private event bus how-to improvements

[robrap]

Here is the private how-to: https://2u-internal.atlassian.net/wiki/spaces/AT/pages/174555142/How+to+Use+the+Event+Bus

This ticket captures a variety of feedback captured from others at different times: Note: Some of this could be ticketed separately.

• Resolve any comments on the doc.
• Does the private how-to mix documentation types? The public one did, but this one may be ok.
• Can tips from Doc for writing brief and useful docs openedx/docs.openedx.org#338 shrink any paragraphs in the document?
  • Feedback: "Too much prose. Needs bullets and monospace."
• Are there any code examples that can be copied directly into the doc, rather than (or in addition) to references via links? (This may no longer apply.)
  • "Copy/paste all commands and code, with links to PRs."
  • Consider what parts could be automated in k8s-app-creator and cookie-cutter tools. Can/should this be tasked?
• Also see Move and improve event bus public how-to openedx/openedx-events#238 for improvements to the public how-to.
  • References to the public how-to will need to be updated when this is complete.