Shamil's Blog. Software Engineering Processes, Android, CI, Devops.

Recently I don't see almost any diagrams in software docs. It seems like the nowadays developers cannot also create any ascii-graphics like this BufferStrategy class doc written 10+ years ago. None of such I've seen in Android docs (point me out to any please?).

Moreover some talented developers seems don't want to document at all. Check out this one, very complex UI behaviour class AppBarLayout.Behavior. It says: "The default AppBarLayout.Behavior for AppBarLayout. Implements the necessary nested scroll handling with offsetting." That's all. What exactly is necessary?

Yes, I've heard many times that mantra of idlers "code source is the best documentation for itself". Without docs it requires sometimes hours or even days to know all the nuances of implementation. In total it requires additional man*years if some popular framework is poorly documented and decreases overall experience of developers and users for using such piece of technology.

So my friend, let's start documenting the sources we write with something more than the usual "f%ck off I'm busy"-style docs and comments that we see in so many docs by adding the details of implementation and side effects. And diagrams!

Labels: android, API, computer science, diagram, docs, documentation, framework, programming

Last week I downgraded Google Play using "Uninstall updates" button (on android ver 2.3.4), so I got fast Market app back (v. 2.3.4). Old Market app worked good and installed apps without problems, but when I needed to test In-app-billing, it for sure did not work :-) (Google requires ) So I tried to force it autoupdate (usually Market and Play apps updated automatically). I even installed all-hated Google Services Framework and Play Services, hoping that they will help Market to autoupdate. They did not. I followed recommendations to clear Market cache and data, but it only cleared list of "My apps". $%$#$&!

So the only way was to manually update Market to Play. As this is original apk signed with Google keys, all went OK. IAB working now.

Labels: android, autoupdate, downgrade, evil, framework, google, market, play, services, update, upgrade