[Asterisk-Users] * INSTRUCTIONS FOR THE ASTERISK COMMUNITY - PLEASE READ NOW *

[Olle E. Johansson]

Welcome to the Asterisk users community!
----------------------------------------

Asterisk.org is a fast moving project. New code is added every day.
Asterisk is the leading Open Source Telephony platform,
with support both for classical telephony and IP telephony.

Our community is also growing fast and we're having a lot
of interaction, on the IRC and on the mailing lists.

It's great to have you participating in this Open Source project
- building an Open Source PBX. Here are a few things to know and
remember while working with the project.

** The mailing list is growing

The lead programmer of Asterisk, Mark Spencer at Digium, inc, half a
year ago wrote:
> The Asterisk community is growing at a remarkable pace.  I know there are
> thousands of you out there -- in fact there are over eight *thousand*
> subscribers to asterisk-users alone, and almost one *thousand* registered
> users on the bug tracker.

Today, we propably have over 10,000 readers. This means that everything
anyone write to this mailing list, is sent to thousands of mailboxes
that is already flowing over with messages.

** Think before sending a message, think twice

I would like to stress the fact that you have to think before you send a
message to such a big list. Do *not* send out personal replies on the list.
If you offer services to someone, do *not* CC: or reply to the list, it
will annoy more potential customers than get you new customers. If you
send out a message by mistake, you don't have to apologize to all of us,
we understand you're embarassed. We will get more annoyed by your apology
than over your first message.

** Try finding the answer first, then ask the list

The Asterisk Wiki at http://www.voip-info.org project is an important
knowledge base for the project.

Go there to find your answer first, then search the mailing list
archives (Google or http://search.voip-forum.com) and then
go to the IRC channel. The IRC channel is populated with Asterisk gurus
around the clock (literally) and they'll help you move forward.

* IRC info: http://www.asterisk.org/index.php?menu=support#irc
* There's many links to Asterisk web pages on the documentation
   page at http://www.asterisk.org
* The Asterisk FAQ is found on the wiki
   http://www.voip-info.org/wiki-Asterisk+FAQ
* The Asterisk documentation project (which needs your help)
   is at http://www.asteriskdocs.org
   Their handbook "The hitchhiker's guide to Asterisk" is already
   well worth reading.

Finally, if you don't find the answer elsewhere, try the list.

** Mailing lists
For developers, there is a developer's list, asterisk-dev.
For BSD users (FreeBSD, NetBSD, OpenBSD and OS/X) there's a
list called asterisk-bsd. There is also a business list
for those that want to ask for commercial services and
inform their community about new services.

You'll find all lists on http://lists.digium.com, which is the
site where you manage your subscription to this list as well.

Please, do not crosspost the same message to multiple mailing
lists. It will not help you, it will only add to the mail flow
and get people that read both lists irritated.

** Reporting bugs
If you think you have found a bug, report it. We need bug reports.
Read this document http://www.digium.com/bugtracker.html and then
go to the bugtracker http://bugs.digium.com to file a report.
If you are unsure, find a bug marshal on the IRC channel to help
you. They're appointed to support you with how to handle bugs.

Please check the bugtracker thoroughly before posting a new bug;
often, your bug or feature already exists but is simply slowly
making it's way through the system.  Duplicate reports slow things
down for everyone, so please spend a few minutes searching first.

The bug tracker is also a place where you add your contribution
to Asterisk. If you have coded extra functionality, make sure you
give it back to the project so it can be added to the code base.
This is how Asterisk grows, free contributions and consultants
that are paid to add functionality on a case by case basis.

** Be a community member - contribute!
The Asterisk software growth is very much based on user contributions.
That's really how we all pay for the software - and get revenue back.
If you develop custom functionality, you can rest assured that there
is someone out there that wants it, needs it and will be helped by it.

Don't forget to contribute. Open Source is both giving and taking.
The financial model behind it all is really cooperative in some way.
As one member to the community said to a contractor:
   "Hey, I'm paying you to deliver code to me, then I'm giving it
    away to the community. How did this happen?"
It's the Open Source business model. And if it didn't work, we
wouldn't have a lot of the software platforms that we all use
in our business systems - Linux, Apache, MySQL, PostgreSQL and
Asterisk.

** Remember: It's Open Source, it's voluntary
Asterisk.org is a Open Source project. This means you can't request
help from people, demand new functions or support. However, there
are many individuals and companies out there that are offering
services based on Asterisk, from VoIP service providers to
consultants all over the world.

Of course, this is also part of Digium's business, so you have
plenty of help if your willing to pay. Digium is to be found at
http://www.digium.com. Service providers and consultants are
listed on the wiki, where you'll find companies all over the globe
that are willing to set up your PBX and get you connected to either
the PSTN or the growing telephony network on the Internet.

* See http://www.voip-info.org/wiki-Asterisk%20consultants


Again, welcome to the Asterisk.org Open Source PBX Project!

Meet you on the IRC channel :-)

/oej

-------------------------------------------------------------
PS. This message will be sent regularly. If you have any
corrections or additional information that needs to be
included, mail me * off list *. Thank you!