[Freeswitch-docs] better documentation

[Mundkowsky, Robert]

Hi,

It is very difficult to use Freeswitch, because the documentation is very difficult to use.

If the documentation was better you would have a lot more users.

For example, in https://wiki.freeswitch.org/wiki/Sofia_Configuration_Files , I can read the whole page and I still do not understand fundamental things like:

1)      What is a domain?

2)      What is a profile?

3)      What is a gateway?

4)      How is a gateway different than a normal SIP end point?

Simple definitions of key ideas and a structured top down descript would help a lot.

And there is a lot of useless statements that one has to read through that does not help. For example, "The best thing to do is take a look at these things from a step back."

Also it is common to explain what something is not, rather than explaining what it is first.

Robert

________________________________

This e-mail and any files transmitted with it may contain privileged or confidential information. It is solely for use by the individual for whom it is intended, even if addressed incorrectly. If you received this e-mail in error, please notify the sender; do not disclose, copy, distribute, or take any action in reliance on the contents of this information; and delete it from your system. Any other use of this e-mail is prohibited.


Thank you for your compliance.

________________________________
-------------- next part --------------
An HTML attachment was scrubbed...
URL: http://lists.freeswitch.org/pipermail/freeswitch-docs/attachments/20150713/b877b008/attachment-0001.html