[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.

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

Meet you on the IRC channel :-)

/oej

** Asterisk version information

At this moment we have two current versions of Asterisk, the
developer version and the stable version. The stable version
is distributed as .tar.gz archives on several servers. The
current stable version of Asterisk is 1.0.5. The stable version
contains no new functions and only changes when bugs are fixed.
The development version is to be used by people that can test
new functions and live with bugs and unexpected shortcomings.

** The mailing list is growing

Today, we propably have over 10,000 readers on the -users list. This
means that everything anyone write to this mailing list, is sent to
thousands of mailboxes that are already flowing over with messages.
That's why we all need to follow some simple rules on how to use
the mailing list and the other tools that are available.

** 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 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.
Do not use this list as a secondary support line if you do
not get an answer on the -users list. It is meant for developer
discussions, not advanced support. If you need answers, there
is a better chance that you will get help on the irc channel.

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 (asterisk-biz).

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. If you are
unsure which list to use, send only to the -users list.

Make sure that you remove unnecessary text when you reply,
to make it easy to browse the mailing list quickly. And please
do not send HTML mail to a mailing list.

** 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 demand
help from community members, nor 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, provide training 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
* For training, see http://www.voip-info.org/wiki-VoIP%20Training

-------------------------------------------------------------
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!