on a practical note, the existing swift documentation is in docbook and if any of this work is intended to actually form part of the swift documentation, it should likely also be in that format. --