[Asterisk-Users] FAQ, Documentation, How-to, etc

[Andrew Nelson]

As a newcommer I can say that saying things like "Check the archive" and 
whatnot do not help at all when your first exposure to the subject thread is 
someone saying "It's already been answered, check the archive" and that 
message is 6 months old!  Worst of all there are no hints on searching for 
this information.  You know in such situations it's helpful to say something 
like this instead, "Ya this topic was discussed a few months ago and the 
outcome was XYZ and So and So started the thread, or the thread title was 
BLA"  Now reading something like that in the archive does wonders towards 
directing further research!

I also think a simple Telco <-> Computer Networking translation guide might 
help some people with the new language of telco.

Just some of my observations.

-Andrew

On Wednesday 19 November 2003 17:35, Rich Adamson wrote:
> Nov 19, 2003
> To Everyone on this list...
>
> What's been suggested for a FAQ and other "much needed information" for
> such a _HIGHLY_ technical software product has been proven thousands of
> times in the past few months. Even an untrained monkey can see that,
> including many geeks. Those that are against it are the very _few_ arrogant
> self-centered egotistical few that think their middle initials are VoIP. It
> would be very easy to publish a list of such names on this list and only
> consume a half-inch of email space (even with Outlook Express in bold
> print, heaven forbid). And, their first names do not start with Mark either
> (Everyone, please note Mark's political absence from this somewhat "hot"
> topic; excellent posture.)
>
> The majority of recent postings to the list are, without a doubt, coming
> from folks that have just recently found an app they believe in and would
> like to try it. But the arrogant _few_ (about 3, if someone's counting)
> consistently discourage these same people with "did you search the
> archives" or "any dumb fxxx" should know that; just read the code!!! If I
> see one more post from those same arrogant <people>, I'm tempted to build
> an army <of you know what> and see how well their business and customers
> stand up to the DS3 <pressure>. (For the arrogant few, substitute the
> best-known very-well- understood words that you can come up with in between
> <>. It shouldn't take more then a couple of Crayons to color between the
> lines.)
>
> A minimum of ten years of Internet history has already proven that sharing
> information is a very positive thing. Yet, on "this" list and with this
> product, the overwhelming objective by those that have a clue is to _not_
> share the intricacies of how to accomplish basic telephony functions. Most
> of us do understand why a couple of cookie-Krums (intended) are scattered
> around though!!!
>
> There has been several attempts by _many_ to help document the product, but
> even _that_ effort has been consistently undermined by a select _few_.
> Until knowledge and experiences are shared <openly>, the product will
> likely remain in its present state. (Sorry Mark!)
>
> For those that have actually read this far, please express your honest
> opinion as they're truly are some people lurking that want to learn and can
> impact the negativity that is so common on this list.
>
> For those that are new to the list and don't understand the frustration,
> please disregard.
>
>
> _______________________________________________
> Asterisk-Users mailing list
> Asterisk-Users at lists.digium.com
> http://lists.digium.com/mailman/listinfo/asterisk-users