<div dir="ltr"><br><br><div class="gmail_quote"><div dir="ltr">On Thu, Oct 8, 2015 at 11:22 PM Richard via cfe-dev <<a href="mailto:cfe-dev@lists.llvm.org">cfe-dev@lists.llvm.org</a>> wrote:<br></div><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex"><br>
[Please reply *only* to the list and do not include my email directly<br>
in the To: or Cc: of your reply.  Thanks.]<br>
<br>
In article <<a href="mailto:CAK_tg0xg7mYqndkS9W1p9g8%2BAEDphMRwM%2Bni_s69NyqcSvWGFw@mail.gmail.com" target="_blank">CAK_tg0xg7mYqndkS9W1p9g8+AEDphMRwM+ni_s69NyqcSvWGFw@mail.gmail.com</a>>,<br>
    Daniel Jasper via cfe-dev <<a href="mailto:cfe-dev@lists.llvm.org" target="_blank">cfe-dev@lists.llvm.org</a>> writes:<br>
<br>
> I think we should first solve the internal documentation problem, i.e.<br>
> consider how we link to 3rd party documents later. For me, the important<br>
> question is where the documentation should actually live. I would prefer it<br>
> to live in the source files itself.<br>
<br>
Me too.<br></blockquote><div><br></div><div>Note that I started this thread specifically to talk about documentation that we don't want to maintain as part of our own source code, because it is much too large for that (look at examples of the C++ core guidelines; every check has a large text with lots of examples why it is enforced).</div><div><br></div><div>I don't think we want to maintain a copy of the C++ core guidelines in our source code.</div><div> </div><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex">
<br>
When the recent commit was made that added the documentation for the<br>
checks to the source tree, Alex and I discussed that it would be<br>
better to have it extracted from source.<br>
<br>
That way, you update the check and fix the comment in the source and<br>
this ends up in the generated doxygen and the generated user<br>
documentation all from a single source of truth.<br>
--<br>
"The Direct3D Graphics Pipeline" free book <<a href="http://tinyurl.com/d3d-pipeline" rel="noreferrer" target="_blank">http://tinyurl.com/d3d-pipeline</a>><br>
     The Computer Graphics Museum <<a href="http://ComputerGraphicsMuseum.org" rel="noreferrer" target="_blank">http://ComputerGraphicsMuseum.org</a>><br>
         The Terminals Wiki <<a href="http://terminals.classiccmp.org" rel="noreferrer" target="_blank">http://terminals.classiccmp.org</a>><br>
  Legalize Adulthood! (my blog) <<a href="http://LegalizeAdulthood.wordpress.com" rel="noreferrer" target="_blank">http://LegalizeAdulthood.wordpress.com</a>><br>
_______________________________________________<br>
cfe-dev mailing list<br>
<a href="mailto:cfe-dev@lists.llvm.org" target="_blank">cfe-dev@lists.llvm.org</a><br>
<a href="http://lists.llvm.org/cgi-bin/mailman/listinfo/cfe-dev" rel="noreferrer" target="_blank">http://lists.llvm.org/cgi-bin/mailman/listinfo/cfe-dev</a><br>
</blockquote></div></div>