Everyone,

What I want to see is someone to start a wiki page that is
a TODO list for missing documentation and then for
*everyone* who uses FreeSWITCH to think back to their first
impression and what things they wish were spelled out better
and add it to that page. Or at the very least submit your account to
this mailing list thread. Or maybe add unanswered questions to the
FAQ page for people to fill in? Something....?

All I have heard are blanket statements like:
"There is little or no documentation..." This is a very
relative statement. What exactly do you want to see?
For instance the API is well-documented with doxygen but if you
don't plan to code anything then that is not any help for you.
There are getting started guides and dialplan guides but maybe
you don't understand the paradigm behind the software enough.
There are nearly 500 wiki pages but maybe none of them tell you
what you want to know?

I obviously do not need any documentation since I invented most
of this stuff off the top of my head and it all makes perfect
sense to me.  I am offering to push for this for everyone else's sake.
This is the whole point of a community project so what we need is feedback or I will consider it safe to assume we are already as well-documented as we can be.


 



 
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

FreeSWITCH Developer Conference
sip:888@conference.freeswitch.org
iax:guest@conference.freeswitch.org/888
googletalk:conf+888@conference.freeswitch.org
pstn:213-799-1400


----- Original Message ----
From: Jonas Gauffin <jonas.gauffin@gmail.com>
To: freeswitch-users@lists.freeswitch.org
Sent: Thursday, September 20, 2007 9:17:54 AM
Subject: Re: [Freeswitch-users] Should I choose FreeSwitch?

> Ahh you kept saying people who 'cant' which led me to believe you were
> talking about people who cant as opposed to wont.  If they wont add, why
> would they add  to something else?   So I am still confused why there needs
> to be a "second class" documenter.  Those that request others do things for
> themselves that they wont.
>
How can they add/improve documentation if they can't understand how things work?
What they can do is to tell us what they don't understand or if they
are missing something.

But how should they do that? And do they know that they can give us feedback?

_______________________________________________
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



Be a better Heartthrob. Get better relationship answers from someone who knows.
Yahoo! Answers - Check it out.