fix YAML, improve markdown, use NULL for duration on failure. nice self-contained commit, then...