dox updates and organization
(#387)
mention periodic interpolation
(#387)