Documentation enhancements

From Yade

What should be documented but is not currently