You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
I think we could structure a tutorial as a series of minimal, self-contained, working recipes (possibly extending the recipe directive to trim down what's included to a certain line range), which would help make sure the recipes get tested in CI. The only other thing might be tooling to ensure that the steps actually progress into each other and don't get out of sync (preventing you from making an edit to only one step).
The text was updated successfully, but these errors were encountered:
What feature or improvement would you like to see?
There's some interesting recommendations here: https://refactoringenglish.com/chapters/rules-for-software-tutorials/
I think we could structure a tutorial as a series of minimal, self-contained, working recipes (possibly extending the recipe directive to trim down what's included to a certain line range), which would help make sure the recipes get tested in CI. The only other thing might be tooling to ensure that the steps actually progress into each other and don't get out of sync (preventing you from making an edit to only one step).
The text was updated successfully, but these errors were encountered: