Start with the task
Describe what you wanted to achieve and the conditions in which you worked. Include tool versions when they affect the result. Do not include access keys or private data.
Separate actions from results
Record the steps in the order needed to repeat them. For each, state the observed result and how to check it. Label a step that has only been proposed.
State the limits
List the conditions under which the solution was tested and the questions that remain open. One successful run does not cover every possible environment.