doc improvements
fix 1d interface