Documentation changes and bug fixes

[achetverikov]

Could someone else test that it works? @mekman @jkosciessa

[jkosciessa]

I successfully ran water and intracranial simulations after merging these updates with my own pull request #8. The code changes also looked sensible.