autogen spec doc - first cut