Improve user facing documentation

[hadley]

So that (e.g.) ?fit provides something useful

Currently the documentation is aimed at the developer, but most of the time the person reading them will be a user looking for documentation about that function. I think that means that the modelling functions need to be broken down into smaller pieces (documenting tightly related functions), and the current documentation moved to (e.g.) @section For package authors:.