<div dir="ltr"><blockquote class="gmail_quote" style="margin:0px 0px 0px 0.8ex;border-left-width:1px;border-left-style:solid;border-left-color:rgb(204,204,204);padding-left:1ex"><span style="font-size:12.8px">Indeed we do! If you ever have questions just ask me via IRC or email.<br></span><span style="font-size:12.8px">I'd be very happy to help.</span></blockquote><div><br></div><div>First of all thank you for the help you've given me so far.</div><div><br></div><div>Maybe I'm different from others, but my workflow as a newcomer was just reading <a href="https://ghc.haskell.org/trac/ghc/wiki/Newcomers" target="_blank">https://ghc.haskell.org/trac/<wbr>ghc/wiki/Newcomers</a>.<br></div><div><br></div><div>My extremely unsophisticated idea is to just update this wiki page so that it's obvious there are people who are willing to mentor newcomers. It seems as though we already have mentors or people willing to be mentors, but we also have people who did not know this was available.</div><div><br></div><div>More specifically, I think it would be useful if under the "Finding a Ticket" section, as an alternative to just picking a ticket, we suggest people to ask either through email or on IRC for a starter ticket. Then, hopefully the people who would be willing to mentor this person can suggest tickets they are equipped to deal with themselves.</div><div><br></div><div>By having newcomers ask for a ticket, we can guarantee that if this person gets a response there would be a mentor available. Also, if someone is too busy to be a mentor, then that person could just choose not to volunteer so that nobody should get overburdened, or at least any more overburdened than they already are.</div><div><br></div><div>It might seem silly and I am probably just too shy, but as someone new I am always very hesitant to email the entire mailing list for help. On the other hand, I also feel bad for emailing a specific person because I figure they are likely very busy. If I were assigned someone to ask for help, especially someone who volunteered himself or herself, I suspect I would not feel so embarrassed to ask for help. I probably should have asked for help more on IRC but to be honest I have only used IRC once or twice in my life, incidentally also for help on Haskell, so it's not something I really remember.</div><div class="gmail_extra"><br><div class="gmail_quote">On Mon, Sep 26, 2016 at 12:13 PM, Ben Gamari <span dir="ltr"><<a href="mailto:ben@smart-cactus.org" target="_blank">ben@smart-cactus.org</a>></span> wrote:<br><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex">Simon Marlow <<a href="mailto:marlowsd@gmail.com">marlowsd@gmail.com</a>> writes:<br>
<br>
> I would rather we *didn't* accept contributions via github, even for small<br>
<span class="">> patches, and instead put more effort into streamlining the Phabricator<br>
> workflow.<br>
><br>
><br>
</span>>    - Adding another input method complicates the workflow, users have to<br>
<span class="">>    decide which one to use<br>
><br>
</span>I think we would want to try to sell the GitHub route as "if you would<br>
like to contribute then we would strongly prefer you use Phabricator,<br>
but if you must and it's a small patch, we will accept it via GitHub."<br>
<br>
>    - Github is not integrated with our other infrastructure, while<br>
>    Phabricator is<br>
><br>
True, but I suspect for the small documentation patches that we are<br>
currently consider this shouldn't matter so much.<br>
<br>
>    - Mutliple sources of contributions makes life harder for maintainers<br>
><br>
It does certainly put yet another task on our plates, but I would argue<br>
that it's actually easier than accepting patches via Trac, which we<br>
already do.<br>
<span class=""><br>
> Let's make the Phabricator workflow easier.<br>
><br>
</span>>    - Why not put arc in the repo, or provide a script that automatically<br>
<span class="">>    downloads it and sets it up?<br>
><br>
</span>I'm not sure how much of a difference placing arc in the repo will make;<br>
the user will still at very least need to install PHP manually.<br>
<br>
>    - I also like the idea of auto-push if validate succeeds.  Or a button<br>
<span class="">>    that you can press on the diff that would do the same thing, so you can get<br>
>    code review first.<br>
><br>
</span>To be clear, I'm a bit weary of opening up the auto-push feature to new<br>
contributors. While regular contributors know what changes can be safely<br>
pushed and which require review, we have no guarantee that a new<br>
contributor has developed these sensibilities.<br>
<br>
>    - +1 to making the manual easier to build.  The same goes for Haddocks;<br>
<span class="">>    it's really hard to make a simple patch to the docs and test it right now.<br>
><br>
</span>The users guide should be quite possible to do.<br>
<br>
I don't believe there is any reliable way to allow a contributor to<br>
build the haddocks without having built GHC (since you need GHC master to<br>
parse `base`, et al.); that being said, we could have Harbormaster<br>
upload built documentation somewhere and then leave a link to it on the<br>
Diff.<br>
<span class=""><br>
> One other thing that came up but wasn't mentioned in the notes: let's be<br>
> more prompt about reverting patches that break validate, even if they only<br>
> break a test.  Now that we have better CI support, we can easily identify<br>
> breaking patches and revert them.<br>
><br>
</span>Agreed.<br>
<br>
Cheers,<br>
<br>
- Ben<br>
<br>
<br>______________________________<wbr>_________________<br>
ghc-devs mailing list<br>
<a href="mailto:ghc-devs@haskell.org">ghc-devs@haskell.org</a><br>
<a href="http://mail.haskell.org/cgi-bin/mailman/listinfo/ghc-devs" rel="noreferrer" target="_blank">http://mail.haskell.org/cgi-<wbr>bin/mailman/listinfo/ghc-devs</a><br>
<br></blockquote></div><br></div></div>