Programming

17741 readers

219 users here now

Welcome to the main community in programming.dev! Feel free to post anything relating to programming here!

Cross posting is strongly encouraged in the instance. If you feel your post or another person's post makes sense in another community cross post into it.

Hope you enjoy the instance!

Rules

Follow the programming.dev instance rules
Keep content related to programming in some way
If you're posting long videos try to add in some form of tldr for those who don't want to watch videos

Wormhole

Follow the wormhole through a path of communities [email protected]

founded 2 years ago

MODERATORS

[email protected]

191

Pointers for writing software tutorials (refactoringenglish.com)

submitted 1 day ago* (last edited 1 day ago) by [email protected] to c/[email protected]

32 comments fedilink hide all child comments

you are viewing a single comment's thread
view the rest of the comments

[–] dajoho 10 points 1 day ago (3 children)

Am I the only one who finds the title abrasive? Why "rules"? Who are you and why should I listen to you? Will you send the tutorial police around if I ignore you? Maybe "recommendations" would be a better choice?

[–] [email protected] 7 points 1 day ago

Unless it's filled with specific uses of MUST, SHALL, and MAY, it's just opinion. This is the internet, so the IMO SHALL be assumed.

[–] [email protected] 3 points 1 day ago

not my title, but it is kinda in your face.

I agree "recommendations" or "pointers" would not come across as so selfğrighteous

[–] [email protected] 1 points 1 day ago

Because rules are meant to be broken :3