<html><head><meta http-equiv="Content-Type" content="text/html; charset=utf-8"></head><body style="word-wrap: break-word; -webkit-nbsp-mode: space; line-break: after-white-space;" class="">Hi,<div class=""><br class=""></div><div class="">With multiple proposals to improve the situation for newcomers in flight, let me add another brief proposal:</div><div class=""><br class=""></div><div class="">Let’s add a CONTRIBUTING.md file to the top-level directory of llvm-project.</div><div class=""><br class=""></div><div class="">I think this would make the information about how to contribute more visible and Github uses CONTRIBUTING.md to display ‘Contributing Guidelines’ at a few places, like when creating new issues or pull requests (<a href="https://github.blog/2012-09-17-contributing-guidelines/" class="">https://github.blog/2012-09-17-contributing-guidelines/</a>). This would be a suitable place to mention that we are not using Github issues/PRs and point to the current procedures for filing issues and sharing patches.</div><div class=""><br class=""></div><div class="">If we decide to add a CONTRIBUTING.md file, the next question is what the content should be. We already have a page intended to summarize the information necessary to file bugs and contribute patches: <a href="https://llvm.org/docs/Contributing.html" class="">https://llvm.org/docs/Contributing.html</a></div><div class=""><br class=""></div><div class="">We could either </div><div class=""><br class=""></div><div class="">1. Duplicate the content of llvm/docs/Contributing.rst in the CONTRIBUTING.md file (I put up a patch to do that a while ago before the transition to the mono-repo, but abandoned it because the feedback was that it was not the right time to do it <a href="https://reviews.llvm.org/D59108" class="">https://reviews.llvm.org/D59108</a>)</div><div class=""><br class=""></div><div class="">2. Have CONTRIBUTING.md mention that Github Issues/PRs are not used at the moment and link to <a href="https://llvm.org/docs/Contributing.html" class="">https://llvm.org/docs/Contributing.html</a>.</div><div class=""><br class=""></div><div class="">3. Move the contents of llvm/docs/Contributing.rst from the docs to CONTRIBUTING.md. Have <a href="https://llvm.org/docs/Contributing.html" class="">https://llvm.org/docs/Contributing.html</a> redirect to CONTRIBUTING.md on Github.</div><div class=""><br class=""></div><div class="">Personally I think we should either go with 2. or 3.</div><div class=""><br class=""></div><div class="">Please let me know what you think!</div><div class=""><br class=""></div><div class="">Cheers,</div><div class="">Florian</div></body></html>