Update user guides

[bgrimstad]

We need to update the user guides before releasing.

In the PDF user guide we need to:

1. Write a little bit more about sampling and knot vectors
2. Write a little bit about the interfaces

Code examples and installation guides will be kept in markdown.