<div dir="ltr"><div class="gmail_default" style="font-family:garamond,serif">OMG This!</div><div class="gmail_default" style="font-family:garamond,serif"><br></div><div class="gmail_default" style="font-family:garamond,serif">I recall going to a website for some opensource program which proudly stated it was written in python and how you could send a pull request but never even told you what it did.</div><div class="gmail_default" style="font-family:garamond,serif"><br></div><div class="gmail_default" style="font-family:garamond,serif">Zach</div></div><div hspace="streak-pt-mark" style="max-height:1px"><img alt="" style="width:0px;max-height:0px;overflow:hidden" src="https://mailfoogae.appspot.com/t?sender=aemtlc3NpbkBnbWFpbC5jb20%3D&type=zerocontent&guid=1de49d58-9a00-414e-bdc3-e28ef56c64a5"><font color="#ffffff" size="1">ᐧ</font></div><div class="gmail_extra"><br clear="all"><div><div class="gmail_signature" data-smartmail="gmail_signature"><div dir="ltr"><div><div dir="ltr"><div><div dir="ltr"><div dir="ltr"><div dir="ltr"><div dir="ltr"><div dir="ltr"><div dir="ltr"><div dir="ltr"><div dir="ltr"><div dir="ltr"><div dir="ltr"><div dir="ltr"><div dir="ltr"><span style="font-family:garamond,serif">Zach Kessin - CEO Finch Software<br><font color="#000000">I boost sales with retail chatbots for fashion and cosmetics</font><br>+972 54 234 3956 / +44 203 734 9790 / +1 617 778 7213</span></div><div><font face="garamond, serif"><a href="https://calendly.com/zkessin/chatbot" target="_blank">Book a meeting with me</a></font></div></div></div></div></div></div></div></div></div></div></div></div></div></div></div></div></div></div>
<br><div class="gmail_quote">On Fri, Mar 2, 2018 at 1:19 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:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex">Many announcements start appear in my inbox like this:<br>
<br>
[erlang-questions] [ANN] SuperWonderFullThing 3.5.1  Released!!!<br>
<br>
Now in many cases (even though I'm a frequent reader of this list)<br>
I haven't a clue what this program does.<br>
<br>
This is a common format:<br>
<br>
   [ANN]   <name> <version> Released !!!!<br>
   <details of feature> *<br>
   <Name> is a <short description><br>
<br>
In extreme cases the short description of what the program does is omitted<br>
<br>
May I respectfully request that all such announcements BEGIN with<br>
a description<br>
<br>
    <Name> is a ....<br>
<br>
Where the ... dots tell me in plain non-technical English what <Name> is<br>
... should be rather short - a few lines - not a Proustian paragraph.<br>
<br>
This should be FIRST not LAST and should always be present.<br>
<br>
<aside><br>
One thing that never fails to astonish me is arriving at a technical web site<br>
and not having a clue as to what the information is all about.<br>
<br>
I'm sure nobody on this list would do that :-)<br>
</aside><br>
<br>
Doing this would probably help spread your wonderful contributions<br>
- which I'm sure might be great if I knew what they did.<br>
<br>
Cheers<br>
<br>
/Joe<br>
______________________________<wbr>_________________<br>
erlang-questions mailing list<br>
<a href="mailto:erlang-questions@erlang.org">erlang-questions@erlang.org</a><br>
<a href="http://erlang.org/mailman/listinfo/erlang-questions" rel="noreferrer" target="_blank">http://erlang.org/mailman/<wbr>listinfo/erlang-questions</a><br>
</blockquote></div><br></div>