Skip to content

Conversation

@niceredfrog
Copy link
Owner

Instructions were: Edit the tutorial as though you’re getting it ready to publish.

This tutorial suffers from assumptions about the prior knowledge of the reader. There are some parts that could benefit from reorganization.

  • Added context about the use case and audience for this tutorial.
  • Divided the tutorial into numbered steps.
  • Added (fictional or best-guess) details to help the reader understand the commands in the tutorial.
  • Added connecting language to show why one step follows another.
  • Added sections: an Overview of all the steps up top, Why Read This, Who Should Read This, definitions of key Terms, and Troubleshooting
  • Fixed proofreading items like inconsistent periods in bulleted lists, inconsistent capitalization in heading, capitalization of Pod/pod, Latinisms, above/below

Instructions were: Edit the tutorial as though you’re getting it ready to publish.

This tutorial suffers from assumptions about the prior knowledge of the reader. There are some parts that could benefit from reorganization.

- Added context about the use case and audience for this tutorial.
- Divided the tutorial into numbered steps.
- Added (fictional or best-guess) details to help the reader understand the commands in the tutorial.
- Added connecting language to show why one step follows another.
- Added sections: an Overview of all the steps up top, Why Read This, Who Should Read This, definitions of key Terms, and Troubleshooting
- Fixed proofreading items like inconsistent periods in bulleted lists, inconsistent capitalization in heading, capitalization of Pod/pod, Latinisms, above/below
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants