I would like to get the FAQ back.

A FAQ is an excellent way of knowing what are missing.
Let users add questions to it, and then use that as a base to improve the documentation. I agree with that a FAQ should not be needed if the documentation is good, but since it's not complete, a FAQ is nice to information about what is missing.

Also encourage people to use the "Talk" link on each page if they find something confusing or not documented properly.

Maybe add a new page called "Documentation requests" where user ask for some parts to be better documented.

Last but not least, instruct users on the firstpage of the wiki how they can give documentation feedback (via any of the above options).

On 9/19/07, Anthony Minessale <anthmct@yahoo.com> wrote:
The important message from this thread is our apparent lack of documentation.  Many of our more complex features are undocumented but one of the main reasons that is the case is that unless we have people volunteering to use the features and help others with them we will be instantly overwhelmed with people who want to use the feature and have little or no interest in contributing anything back to the project.  It will be inevitable that we will have users of FreeSWITCH who give little back but I am not in a big hurry to invite this type of user while we are still in beta.  Our lack of documentation does add up to over 500 pages mind you so I would possibly suggest that we have a lack of a proper table of contents more than a lack of documentation.

So what I would like to do at this time is call on everyone out there on this mailing list to form a collaborative wiki page and to reply to this thread documenting what is missing from the documentation and what you would exactly like to see to be satisfied with the documentation.  Also if you could list every feature you know FreeSWITCH can do (I only tell a handful of people about certain features so once everyone writes them down you may be shocked).

 
Anthony Minessale II

FreeSWITCH http://www.freeswitch.org/
ClueCon http://www.cluecon.com/

AIM: anthm
MSN:anthony_minessale@hotmail.com
GTALK/JABBER/PAYPAL:anthony.minessale@gmail.com
IRC: irc.freenode.net #freeswitch


----- Original Message ----
From: Lucia Rotger < lrotger@aircomp.aero>
To: freeswitch-users@lists.freeswitch.org
Sent: Tuesday, September 18, 2007 2:20:28 PM
Subject: Re: [Freeswitch-users] Should I choose FreeSwitch?

Thanks. As of now there are a lot of options. A BRI/SIP gateway has been  
suggested but as I'm starting out I'd like to narrow things down and keep  
it simple. I think I'll go with Asterisk (gasp) and keep an eye over here  
so I'm aware of the developments. Unfortunately I cannot contribute code  
but I will set up a FS at home and if it works, let it handle some lines  
at the office after BRI support comes up eventually.

When I get the feeling of FS I'll contribute to the wiki, and I'm hoping  
to make it better. What's needed is a good and accurate reference of  
everything it can do, examples are secondary and if that's the only thing  
you see about an option it lets you wondering what more there is to that  
particular option. But I agree wholeheartedly that writing documentation  
for beta code is difficult.

I've set up an account at pbxes, it's quite interesting.

Best regards
Lucia

On Tue, 18 Sep 2007 18:54:30 +0200, Jonas Gauffin  
< jonas.gauffin@gmail.com> wrote:

> I've never used Asterix and FreeSwitch is my first softswitch. But
> I've been programming applications for pbx:es for about 10 years. I've
> done so for brands like Alcatel, Philips, Nec, Ascom and 3COM.
>
> I agree with you that the wiki is still very incomplete, but it's
> updated quite often. If you miss anything, just ask in this list and
> we'll update the wiki.
>
> Also, more are more providers give you the option to connect with SIP
> instead of BRI.
>
> I really like FS and can recommend it. There are some things still
> missing, but those will get implemented eventually.
>
> As you, I'm quite new to VOIP.
>
> //Jonas
>
> On 9/18/07, Lucia Rotger < lrotger@aircomp.aero> wrote:
>> I have to implement a production software PBX. After some googling I  
>> came
>> out with two candidates: Asterisk and FreeSwitch.
>>
>> Asterisk looks like crap; granted, it's working in many installations  
>> and
>> seems to be readier for prime time. But just looking at their bugs puts  
>> me
>> away. Segfaults all over the place, crashes after handling a few hundred
>> calls: in short, very poor, sloppy programming I think. Maybe I'm wrong
>> here?
>>
>> I like the way things are handled here and I like the coding style a  
>> lot.
>> I think it's a matter of time FS becomes a great piece of software. Also
>>  from looking at the bug tracker the issues don't seem to be like those
>> plaguing Asterisk.
>>
>> What are your thoughts? apart from the obvious bias you have for FS  
>> since
>> you are here?
>>
>> I'd also like to read documentation if I have to consider FreeSwitch. I
>> see the wiki is incomplete in many places. There are
>> variables/applications I can't even begin to guess what they do.
>>
>> Also I'm aware that FS is a platform and Asterisk if just a PBX so its
>> ambitions are greater; in fact I only want a PBX not a communications
>> framework but as I've said above I feel Asterisk is going to be a lot of
>> pain.
>>
>> The PBX will have to handle no more than 24 calls through 12 BRI  
>> channels.
>> The local phones will be SIP and the traffic will be mainly incoming  
>> calls
>> although outgoing calls will be made also. I've never touched anything
>> VoIP so I'm a total newbie.
>>
>> Thanks,
>> Lucia Rotger
>>
>> _______________________________________________
>> Freeswitch-users mailing list
>> Freeswitch-users@lists.freeswitch.org
>> http://lists.freeswitch.org/mailman/listinfo/freeswitch-users
>> UNSUBSCRIBE:http://lists.freeswitch.org/mailman/options/freeswitch-users
>> http://www.freeswitch.org
>>
>
> _______________________________________________
> Freeswitch-users mailing list
> Freeswitch-users@lists.freeswitch.org
> http://lists.freeswitch.org/mailman/listinfo/freeswitch-users
> UNSUBSCRIBE: http://lists.freeswitch.org/mailman/options/freeswitch-users
> http://www.freeswitch.org
>



_______________________________________________
Freeswitch-users mailing list
Freeswitch-users@lists.freeswitch.org
http://lists.freeswitch.org/mailman/listinfo/freeswitch-users
UNSUBSCRIBE:http://lists.freeswitch.org/mailman/options/freeswitch-users
http://www.freeswitch.org



Don't let your dream ride pass you by. Make it a reality with Yahoo! Autos.

_______________________________________________
Freeswitch-users mailing list
Freeswitch-users@lists.freeswitch.org
http://lists.freeswitch.org/mailman/listinfo/freeswitch-users
UNSUBSCRIBE: http://lists.freeswitch.org/mailman/options/freeswitch-users
http://www.freeswitch.org