proceeded with writing docs (refs #3)