add miredot annotations and gen-apidocs.sh script