Expand documentation on algebra types

[paulgessinger]

We have a little bit of language on the ActsScalar here, but with the thorough renaming, maybe this could get some love.

@msmk0 maybe?

[msmk0]

Yes, I also have to fix the related issue #323.