You could do

    faultdef
        FOO, // comment
        BAR, // comment
        QUX; // comment

There are third party tools to generate docs. You can also get some json output from the c3 compiler itself to base docs on