Better API documentation formatting

resolves #35