Running sphinx in the "default" way fails, because the destination directory doesn't exist, and readthedocs for example fails to build the documentation. WARNING: "latex_documents" config value references unknown document index Error in atexit._run_exitfuncs: Traceback (most recent call last): File "/usr/lib/python2.7/atexit.py", line 24, in _run_exitfuncs func(*targs, **kargs) File "/home/docs/sites/readthedocs.org/checkouts/readthedocs.org/user_builds/gnu-mailman/checkouts/latest/conf.py", line 225, in index_html os.chdir('build/sphinx/html') OSError: [Errno 2] No such file or directory: 'build/sphinx/html' Error in sys.exitfunc: Traceback (most recent call last): File "/usr/lib/python2.7/atexit.py", line 24, in _run_exitfuncs func(*targs, **kargs) File "/home/docs/sites/readthedocs.org/checkouts/readthedocs.org/user_builds/gnu-mailman/checkouts/latest/conf.py", line 225, in index_html os.chdir('build/sphinx/html') OSError: [Errno 2] No such file or directory: 'build/sphinx/html' -- You received this bug notification because you are a member of Mailman Coders, which is subscribed to GNU Mailman. https://bugs.launchpad.net/bugs/953531 Title: Add graphs of the overall architecture To manage notifications about this bug go to: https://bugs.launchpad.net/mailman/+bug/953531/+subscriptions

Maybe we could reuse diagrams from http://aosabook.org/en/mailman.html . -- You received this bug notification because you are a member of Mailman Coders, which is subscribed to GNU Mailman. https://bugs.launchpad.net/bugs/953531 Title: Add graphs of the overall architecture To manage notifications about this bug go to: https://bugs.launchpad.net/mailman/+bug/953531/+subscriptions