To proceed, open <filename>.dmg
-
<img src="/uploads/default/2426/61fd66592928b208.png" width="478" height="44”>
-
I don't Mac, but I always read the .dmg extension as "damage."
-
Also, it's Flash, so in this case it's probably right despite what .dmg actually means.
Filed under: Too hungover for googles
-
Anybody reading it as "Dungeon Master's Guide"?
-
To me it looks like "dung" with the
u
upside down.
-
It's entirely possible to ship an OSX application as
.tar.gz
but I think there's a few downsides to that (such as annoying restrictions on file metadata). I prefer to tell someone else to deal with that sort of thing for me though.I truly hate doing release engineering…
-
-
I find writing documentation quite beneficial. Since I usually get roped in to write user documentation as well as technical documentation, I get to play a meta form of rubber duck debugging in both cases, which can be very useful to improving things. If I can't explain it, it probably needs improvement.
-
Seems nobody’s noticed the <filename> part (admittedly, it’s gotten lost on the front page Sidebar WTF), which is what I was actually trying to point out: that Adobe puts a placeholder filename in their instructions that have clearly been written for users who are assumed to hardly ever have seen a computer before. It’s not just in English either — when I went to download said Flash installer from the Dutch-language page, it said “<bestandsnaam>.dmg” meaning the translator also seems to have thought this wasn’t a placeholder.
Edit: great, < and > need to be done as HTML escapes in posts too, else everything between them disappears here as well.
-
That's because HTML is valid posts, at least some whitelisted subset of it.. e.g. bold
<b>bold</b>
-
If I can't explain it, it probably needs improvement.
You've also got to think about who the audience is. Explaining something to us is different to explaining things to some random person pulled off the street. The other thing is that you've got to remember to map out the forest as well as labelling all the trees; too many developers get lost in enumerating all the details when documenting things and forget the big picture.
Filed under: Occasionally I manage to get that right…
-
I had assumed that remembering the audience was something of a given...
-
That's because HTML is valid posts, at least some whitelisted subset of it.. e.g. <b>bold</b>
<b>bold</b>
So why don't you just leave the non-whitelisted subset as is? Shouldn't be that hard to do.
-
I thought Markdown was supposed to save us from that icky, old-school HTML stuff...
-
Anybody reading it as "Dungeon Master's Guide"?
No, just you, but here, have a nerd badge:
-
I don't subscribe to the stereotype of a nerd with thick glasses that are haphazardly repaired in the middle.
A proper nerd takes care of their tools and implements, and would wear glasses in a style of their personal preference, and they would not be broken.