add link to schema spec in overview too
expand command line instructions