barry-jones / live-documenter

.NET documentation generator and live reader. Generate documentation from .NET code and xml comments, fast, quick and easy.
https://livedocumenter.barryjones.me.uk
MIT License
71 stars 4 forks source link

generated xml for enumerations handles values differently to other members #25

Open barry-jones opened 5 years ago

barry-jones commented 5 years ago

Normally a members fields, properties, methods etc are stored as an entry under an entries element with details of the id, type naem and cref etc e.g.

<entries>
    <entry id="4294969814" subId="" type="constructor" visibility="protected" cref="M:TheBoxSoftware.Reflection.Signatures.SignatureConvertor.#ctor">
        <name>SignatureConvertor()</name>
    </entry>
</entries>

Enumerations are handled as values.

<values>
    <value>
        <name>MethodDef</name>
        <description>
            <summary>
                <text>Signiture which describes the signiture or of a method or global function. </text>
            </summary>
        </description>
    </value>
</values>

Consider converting the same format as all of the others to simplify XSLT processing.