SwordInStone@lemmy.world to Programming@programming.dev · edit-22 days agoPointers for writing software tutorialsrefactoringenglish.comexternal-linkmessage-square32fedilinkarrow-up1195arrow-down14cross-posted to: [email protected]
arrow-up1191arrow-down1external-linkPointers for writing software tutorialsrefactoringenglish.comSwordInStone@lemmy.world to Programming@programming.dev · edit-22 days agomessage-square32fedilinkcross-posted to: [email protected]
minus-squaredajoholinkfedilinkarrow-up11arrow-down1·2 days agoAm 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?
minus-squareMagicShel@lemmy.ziplinkfedilinkEnglisharrow-up7·2 days agoUnless 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.
minus-squareSwordInStone@lemmy.worldOPlinkfedilinkarrow-up3·2 days agonot my title, but it is kinda in your face. I agree “recommendations” or “pointers” would not come across as so selfğrighteous
minus-squareNostraDavid@programming.devlinkfedilinkarrow-up1·2 days agoBecause rules are meant to be broken :3
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?
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.
not my title, but it is kinda in your face.
I agree “recommendations” or “pointers” would not come across as so selfğrighteous
Because rules are meant to be broken :3