added little first api "documentation"

well, those are more random thoughts...