: Is writing "Bad practice"-notes in tech guides bad style? So, I'm in the process on writing a hardening guide for Windows 10. Similar to http://hardenwindows10forsecurity.com/index.html, but different

Vote Up Vote Down

The reason many guides suggest avoiding this is that some readers may not have considered doing things in a specific wrong way, and that mentioning it puts it into your reader's mind.

Don't think about a white bear. See what I mean? (https://en.wikipedia.org/wiki/Ironic_process_theory)

I think you're on the right lines with not giving specifics and putting a vague summary - and I agree with Secespitus about putting it next to the right way to do things and explaining why.

(0)

Vote Up Vote Down

It's very important to show users what they should not do and even more important is to explain why they should not do this.

Think of a kid: you tell it not to touch the hot surface.

... Guess what will happen five minutes later.

If you instead told the little kid that it will hurt very bad if they touch the surface because it's very hot, hotter than a candle, they will think about it twice. Depending on their experience with candles this might still lead to problems, but there will be a lot less incidents.

You want to go for the latter approach and save as many kids from hurting themselves as you can by telling them what they should not do and why they should not do it.

Your points are valid and important but the most important point is not to write:

"This will be faster, but less secure"

You want to write:

"This will save you a few minutes now, but once you have more than x users it will severely hinder your ability to perform [x] because you would have to manually change hundreds of lines - and if you miss one of them you will have a security hole that will easily grant an attacker access to your passwords."

Make it obvious why it's a bad idea. The more "You will have to do a lot more work" the better and a big "If you do this you are doomed once someone attacks you" will be better than anything else in getting people away from this action.

Don't forget to focus on the Good Practices though. It's important to mention the Bad Practices, but in general that should only be a few paragraphs or a little box at the bottom of a page with a big warning label. You are there to show them how to it right and explain why that is the right way to go, for example by mentioning the problems they will have if they don't follow your advice.

When it comes to security for example you have to know how your attackers think to be able to come up with countermeasures. If you always say that you don't need this knowledge because you are one of the good guys then the bad guys will have an easy target that knows nothing about their strategies. That would be like not telling your kids that people stealing your purse exist. Even if you don't want to encourage them to steal purses, you have to tell them that people do and how they normally do it so they can keep their purse secure.

(0)