<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=""><br class=""><div><br class=""><blockquote type="cite" class=""><div class="">On Mar 7, 2019, at 1:58 PM, Tanya Lattner <<a href="mailto:tanyalattner@llvm.org" class="">tanyalattner@llvm.org</a>> wrote:</div><br class="Apple-interchange-newline"><div class=""><div class="">The LLVM Project has not officially moved to GitHub yet and I would like to avoid fragmenting the project by having documentation in multiple places or done in different ways. There does need to be a discussion about what the best steps forward are in terms of documentation, bug tracker, etc. In regards to documentation, I have been looking for someone to help drive this topic as we need to do a cost/benefit tradeoff, explore some issues and determine what the best next steps are. If someone is interested in work on this, please let me know. I am happy to contribute information on what we do now and what is working and what is not.<br class=""><br class="">-Tanya<br class=""><br class=""><blockquote type="cite" class="">On Mar 7, 2019, at 1:21 PM, Renato Golin via Phabricator <<a href="mailto:reviews@reviews.llvm.org" class="">reviews@reviews.llvm.org</a>> wrote:<br class=""><br class="">rengolin added a comment.<br class=""><br class="">I'm not against moving docs there but I think there should be a conversation about the broader subject of docs, github, wiki, etc.<br class=""><br class="">Last time we discussed the media we use was years ago and a lot has changed since. Not to mention the broken infea we have to validate and build docs, that would come for free from github.<br class=""><br class="">I personally recommend we do a whole move, possibly keeping them in docs but linking from the root tree. We have too many docs to move down, though, contributing is a standard root doc anyway.<br class=""><br class=""><br class=""></blockquote></div></div></blockquote><br class=""></div><div><br class=""></div><div>Thanks Tanya & Renato! I agree we should not fragment the documentation and CONTRIBUTING.md would only makes sense once LLVM officially moves to Github. I think CONTRIBUTING.md is a bit special in a way similar to README.md. They are treated in a special way by Github’s UI, but their major benefit is for projects using pull requests and/or Github issues, which is not the case right now. </div><div><br class=""></div><div>The main intention was to make the contributing information easier to discover. Maybe something like adding a link to <a href="http://www.llvm.org/docs/Contributing.html" class="">http://www.llvm.org/docs/Contributing.html</a> to <a href="http://llvm.org" class="">llvm.org</a> would be better. And/Or add a link to CONTRIBUTING.md that just points to the docs</div><div><br class=""></div><div>Cheers,</div><div>Florian</div></body></html>