write_riemann: add documentation