[Mesa-dev] Documentation patch

[Eric Anholt]

"Rogovin, Kevin" <kevin.rogovin at intel.com> writes:
> Additionally, I really, really, want the text in doxygen/doxy_text to
> eventually land in src/ and a policy put in place that as patches are
> added the corresponding doxy_text files are updated to reflect the
> patch. This will keep the documentation up to date and useful for new
> developers to ramp up more quickly. I am quite *new*, but as a newbie
> I can see the pain of a newbie. Before placing it in src/, I want to
> make sure that which is written is both useful and accurate.
>
>
> Because of the size of the patch (98KB) I've attached the patch rather
> than in-lining it into the e-mail.

You're unlikely to find someone to review a 98kb patch.  You need to
come up with a series of incremental improvements to send to the list
using git send-email.

I don't like the idea of documentation moving away from the code itself.
One of the best features of doxygen is that the docs are right there in
the code so that normal developers might notice and fix it.
-------------- next part --------------
A non-text attachment was scrubbed...
Name: not available
Type: application/pgp-signature
Size: 835 bytes
Desc: not available
URL: <http://lists.freedesktop.org/archives/mesa-dev/attachments/20131004/baa40ba2/attachment.pgp>