<html><head><meta http-equiv="Content-Type" content="text/html charset=utf-8"></head><body style="word-wrap: break-word; -webkit-nbsp-mode: space; -webkit-line-break: after-white-space;" class=""><br class=""><div><blockquote type="cite" class=""><div class="">On Jun 22, 2017, at 12:32 AM, Jacob Bandes-Storch via swift-dev <<a href="mailto:swift-dev@swift.org" class="">swift-dev@swift.org</a>> wrote:</div><br class="Apple-interchange-newline"><div class=""><div class="">Hi,</div><div class="">I’ve thought about this issue in the past too, and would be happy to help write some content or at least proofread / contribute tidbits to a guide for new developers.</div><div class=""><br class=""></div><div class="">As pointed out in this thread, a lot of Swift infrastructure and paradigms comes from the LLVM community, but spelling that out in a “Getting Started” guide would be nice.</div></div></blockquote><div><br class=""></div><div>Patch?</div><br class=""><blockquote type="cite" class=""><div class=""><div class=""> It’d also be worth gathering some tips & tricks for developing & debugging issues, using Xcode or otherwise.</div></div></blockquote><div><br class=""></div><div>There is already a file like this if you want to extend it. It is ./docs/DebuggingTheCompiler.rst.</div><br class=""><blockquote type="cite" class=""><div class=""><div class=""><br class=""></div><div class="">Would a Markdown document in the apple/swift repo be the best place for such a thing?</div></div></blockquote><div><br class=""></div><div>See above ; ).</div><div><br class=""></div><div>I imagine if you wanted to convert it to markdown, I don't think anyone would object. But I could be wrong.</div><br class=""><blockquote type="cite" class=""><div class=""><div class=""><br class=""></div><div class=""><br class=""><div class="gmail_quote"><div class="">On Tue, Jun 20, 2017 at 12:37 PM Halen Wooten via swift-dev <<a href="mailto:swift-dev@swift.org" class="">swift-dev@swift.org</a>> wrote:<br class=""></div><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex">Hi,<br class="">
<br class="">
I would like to start a discussion about getting started with the<br class="">
Swift Compiler. The end goal is to see if there are ways we can help<br class="">
newcomers to the compiler get started and more quickly grow into a<br class="">
more effective contributor. The motivation is that I've had a<br class="">
surprising amount of trouble with my starter bug. Swift is amazing and<br class="">
I would love to contribute more regularly, but I also don't want to<br class="">
burden the core team.<br class="">
<br class="">
I know that documentation on a huge project like this is a<br class="">
non-starter, but I wonder if we could have better information on the<br class="">
contribution process, which likely wouldn't change frequently. For<br class="">
example, I learned through a conference talk that Swift uses LLVM's<br class="">
lit testing. I couldn't find that in any of Swift's documentation. The<br class="">
docs explain how to run tests, but not how to write them. I would be<br class="">
happy to help out with documentation if we can decide on changes that<br class="">
would be useful.<br class="">
<br class="">
Also, after I'm able to get my starter bug merged, I have no idea<br class="">
where to go from there. I don't want to take another starter bug and<br class="">
deprive someone else of the opportunity to contribute (although maybe<br class="">
that's an unnecessary restriction I'm placing on myself), but I'm also<br class="">
not in a place where I could take on something much larger.<br class="">
<br class="">
The learning curve for a compiler is always going to be high, but does<br class="">
anyone have ideas on how we could assist newcomers with their first<br class="">
starter bug and then transitioning into something larger?<br class="">
<br class="">
Thanks,<br class="">
<br class="">
Halen<br class="">
_______________________________________________<br class="">
swift-dev mailing list<br class="">
<a href="mailto:swift-dev@swift.org" target="_blank" class="">swift-dev@swift.org</a><br class="">
<a href="https://lists.swift.org/mailman/listinfo/swift-dev" rel="noreferrer" target="_blank" class="">https://lists.swift.org/mailman/listinfo/swift-dev</a><br class="">
</blockquote></div></div>
_______________________________________________<br class="">swift-dev mailing list<br class=""><a href="mailto:swift-dev@swift.org" class="">swift-dev@swift.org</a><br class="">https://lists.swift.org/mailman/listinfo/swift-dev<br class=""></div></blockquote></div><br class=""></body></html>