<div dir="ltr">Hi Joe,<br><div class="gmail_extra"><br><div class="gmail_quote">On Fri, Sep 23, 2016 at 12:45 PM, Joe Armstrong <span dir="ltr"><<a href="mailto:erlang@gmail.com" target="_blank">erlang@gmail.com</a>></span> wrote:<br><blockquote class="gmail_quote" style="margin:0px 0px 0px 0.8ex;border-left:1px solid rgb(204,204,204);padding-left:1ex"><span class="gmail-">On Fri, Sep 23, 2016 at 10:23 AM, Vlad Dumitrescu <<a href="mailto:vladdu55@gmail.com">vladdu55@gmail.com</a>> wrote:<br>
> Hi!<br>
><br>
> On Fri, Sep 23, 2016 at 10:13 AM, Joe Armstrong <<a href="mailto:erlang@gmail.com">erlang@gmail.com</a>> wrote:<br>
>><br>
>>  If I see a typo (a simple spelling error) in the on-line documentation<br>
>>    the barrier of entry for fixing it is HUGE (sorry for SHOUTING).<br>
>><br>
>>    Download the entire distribution - unpack (240 MBytes) find the<br>
>>    typo (where the heck is it?) - fix it - make a push request ....<br>
>><br>
>>    Do I really have to download hundreds of Megabytes to fix a one<br>
>>    character typo?<br>
><br>
><br>
> Github allows you to make small corrections online, without downloading<br>
> anything. If you don't already have a fork of the repo, it will be created<br>
> and you will get an option to create a PR for the fix (commiters can commit<br>
> directly to a branch).<br>
<br>
</span>Can my dearly beloved wife do this?<br>
<br>
Helen is *very* good at spelling and has found many typos in my<br>
drafts (bless her) - but she's never heard of github - and thinks that<br>
a fork is something you eat food with ..<br>
<span class="gmail-"><br>
> Just go to the file in the source tree and press the "Edit this file" button<br>
> (the pen in the upper right corner).<br>
<br>
</span>"Just" - if you can find the file in the source tree that is<br>
<br>
/Joe</blockquote><div><br></div><div>In your initial comment, you said "If I see a typo", not "if my wife sees a typo" :-)</div><div><br></div><div>I suppose your wife isn't very used to downloading the 240 MBytes, unpacking them, fixing the file and publishing the change, either. This was the scenario for which I suggested a simpler alternative.</div><div><br></div><div>There is an even better way, actually, even if it still requires a Github account in its current form. I don't remember where I saw it first, but I use it for the erlide documentation (which I am well aware that is lacking in all other respects): each generated page has at the bottom the message shown below, where the link opens the source file (markdown, in this case) from which it was generated in the on-line Github editor. This is something that could be added to the OTP docs too (but hand-editing Docbook XML is not as much fun as it sounds like :-\ )</div><div><br></div><div><span style="color:rgb(51,51,51);font-family:"helvetica neue",helvetica,arial,sans-serif;font-size:12.8px;background-color:rgb(245,245,245)">> Did you find errors in the documentation? Do you have improvements to suggest? </span><a href="https://github.com/erlang/erlide_eclipse/edit/master/org.erlide.help/articles/eclipse/250_Editor.md" style="color:rgb(0,136,204);text-decoration:none;font-family:"helvetica neue",helvetica,arial,sans-serif;font-size:12.8px;background-color:rgb(245,245,245)">Suggest edits!</a><br></div><div><br></div><div>best regards,<br></div><div>Vlad</div><div><br></div><div> </div><blockquote class="gmail_quote" style="margin:0px 0px 0px 0.8ex;border-left:1px solid rgb(204,204,204);padding-left:1ex"> <br></blockquote></div></div></div>