One recurring theme with Android documentation is also showing example usages for the absolutely simplest, most straightforward cases - once you try implementing this in a real app, it turns out things are way more complex