Document the channel example
Replace ShallowWater* by SW*

It reduces the problem of long class names
Add some more documentation on the channel example