2 ms·
Did they improve it recently ? I haven’t developed for Android in a while but it used to be terrible. Full of absolutely useless method descriptions. For examp
by Aaargh20318 4y ago
Did they improve it recently ? I haven’t developed for Android in a while but it used to be terrible. Full of absolutely useless method descriptions.
For example, I remember getting frustrated because of the docs for a setTextSize method, with the helpful description “sets the text size”. Nice. Very helpful that it didn’t mention what unit the parameter was, especially since (after experimentation) it turns out the unit is not the one you would expect for a font size.
The API docs were full of that kind of ‘documentation’, setX: “Sets X”.
If you are writing documentation, please explain what method parameters and return values actually mean, what the units used are. Especially if uses a unit no one expects. For example: font sizes are usually specified in points, if you expect them to be specified in pixels you should absolutely mention that.