updating api doc

updating hashspace template notation and added some missing paragraphs

Close #259