I think it's unnecessary and way too much to maintain and think about.
Indeed.
I've forseen ansible/ and ansible-docs/ living beneat a single
directory:
my-dir/
ansible/
library/...
ansible-docs/
rst/
Makefile
1. In "ansible" a `make manpages' will create *.man
2. In "ansible-docs", a `make' will generate include file for .rst (PR
submitted 5m ago) and will create all static HTML as has been done so
far. (Nothing else changed there!)
Later on, I'd like an "ansible-booklet/" at the same level for the rest
(but that's still on the horizon somewhere)
We basically have this already, it's "make docs". It would have to
call the module formatter once to output the JSON
file. Super easy.
That's the way I envision it, too.
-JP