documentation

Organize album order in Flickr

I like Flickr. I have been a paying user for years, since the heady days of Web 2.0. Very photo, so web.

But their documentation fucking sucks. It went down in quality when Yahoo took over, and SmugMug isn’t doing much better. But anyway.

Here’s how to reorganize the order in which albums in the Flickr mobile app show up:

  1. Log in to Flickr on the web
  2. Go to the Albums & Collections section of the Organizr.
  3. At the top of the page make sure Viewing: All Albums is selected.
    Flickr Album Organizr
  4. On the right panel order the albums whichever way you want.

Making this change will have effect in two places:
– The Albums page on the web
Flickr Album page on website

  • The Albums page in the mobile App.
    Flickr Album page on Android mobile app

Neither the Flickr Help Center nor the Help Forum have any posts about this. Now, I’m using the Android app but I assume the iOS-based versions will also follow the ordering set in the Organizr panel.

I wish Flickr enabled a few things:
– Sorting by album metadata (alphabetically, album creation date)
– Sorting by picture metadata (make bigger/smaller albums show up first/last). This would include sorting by last album upload, so albums used the most get shown first.
– Make Collections a first-class citizen on the site. They’ve been relegated as a little used organization tool that no one uses and when it does get used it isn’t showcased.

Flickr has so much to win now that Instagram is being integrated ever more into facebook’s grubby infrastructure.

Never write documentation hangry, e.g. this post

I find I Love MDN demeaning to technical writers. It reminds me of breaking into spontaneous applause for our courageous health workers instead of funding them properly so they can do their jobs.

Source: I Love MDN, or the cult of the free in action – QuirksBlog

Another article related to the fall of Mozilla. Back in the day we relied heavily on quirksmode.org and doing that sort of data mining, collating, writing and publishing is not easy. For a while myself helped out writing documentation for WordPress during the <.09 era and we found out for myself exactly how hard technical writing is. It’s something we’re good at and, more importantly, enjoy. We appreciate the skill, nuance, talent and even luck that goes into writing good documentation.

It is something that we complain about often on teh twitter derp corn; often using ultraviolent language cos most developers are assholes. We’ve mentioned on this here blargh of using vimwiki. Their documentation looks like… actually, not even going to bother with a screenshot because they don’t have anything on their github or wiki that actually says “Documentation”. They take the easy way out and tell you “oh run :h vimwiki in vim”.

No, fuck you, lazy assholes.

Another few great examples of technical writing gone wrong:

  • Pretty much any plugins for vim. Most of them are just the same text file you’d use :h for, except without hyperlinking.
  • VirtualBox coming in with the one-page User Manual
  • Nextcloud, with documentation full of gotchas that should be mentioned prior or during installation, but aren’t.
  • Apple: Documentation? What’s that? Also there never was any documentation here.

Agent J: Move along, nothing to see here

I just had to use a gif for Apple. It’s that bad. Most Android apps don’t have any documentation of any kind whatsoever. Windows applications used to have documentation built-in but now they just direct you to their website, where documentation changes and disappears depending on the A-level goals for the quarter.

There are many more examples out there but these are some of the ones I can think of right now. The gist of it is this kind of thing is hard and people who do it should be paid for it, and if they’re good at it they should be paid well. If a developer doesn’t want to write proper documentation then… they should either have someone do it for them and listen to that feedback, or get their ass handed to them so they get on writing it themselves.

Going to go eat something now before the hunger makes me angrier.

HEAT Plus Knowledge

I can’t say much… yet. Except this misbegotten piece of… whatever it is, makes me want to go Bear Jew on it.

I’ll say more in a bit, providing more context. But be forewarned: If you are considering it for documentation purposes at your enterprise, you’re better off building a tiddlywiki, or just go with a full-fledged MediaWiki instance.

At least then the thing will be compatible with browsers that are not Internet Explorer 6.