Update notes in paramtk

[Chris B]

1. Update demo code.
2. Explain that code is much more complex than necessary, and document plans to wrap it in a simpler interface (with the aim of eventually replacing the original code with something much simpler).