I guess some of it is simply opinion and personal preferences. In my opinion, good UI doesn't require users to go searching for documentation pages.