<html><head><style type="text/css"><!-- DIV {margin:0px;} --></style></head><body><div style="font-family:courier,monaco,monospace,sans-serif;font-size:12pt">Ha,<br><br>Too bad all the text going back and forth in this thread<br>was not actual documentation instead of deliberations about<br>documentation practices or we'd be done already =D<br><br>Anyone who want's to do anything to help the documentation<br>effort by my guest to make any wiki page etc you need.<br>I don't see a mad rush of volunteers so I won't hold my breath<br>or anything but if I run out of bugs to fix and code to write<br>I will start working on this myself.....<br><br><div> </div><div>Anthony Minessale II<br><br><span>FreeSWITCH <a target="_blank" href="http://www.freeswitch.org/">http://www.freeswitch.org/</a></span><br><span>ClueCon <a target="_blank" href="http://www.cluecon.com/">http://www.cluecon.com/</a></span><br><br>AIM:
anthm<br>MSN:anthony_minessale@hotmail.com<br>GTALK/JABBER/PAYPAL:anthony.minessale@gmail.com<br>IRC: irc.freenode.net #freeswitch</div><div><br>FreeSWITCH Developer Conference<br>sip:888@conference.freeswitch.org<br>iax:guest@conference.freeswitch.org/888<br>googletalk:conf+888@conference.freeswitch.org<br>pstn:213-799-1400</div><div style="font-family: courier,monaco,monospace,sans-serif; font-size: 12pt;"><br><br><div style="font-family: times new roman,new york,times,serif; font-size: 12pt;">----- Original Message ----<br>From: Jonas Gauffin <jonas.gauffin@gmail.com><br>To: freeswitch-users@lists.freeswitch.org<br>Sent: Thursday, September 20, 2007 8:47:15 AM<br>Subject: Re: [Freeswitch-users] Should I choose FreeSwitch?<br><br><div>I'm not talking about if people can or can't edit the pages.<br><br>I'm talking about users that want to find or read documentation (not<br>contribute). For instance: New users.<br><br>They want to find
documentation and read it. Those users can give<br>valuable feedback to us (so that we can make the documentation better)<br>if they do not understand it / think that some documentation is<br>missing.<br><br>What I want is a way for those users to give us that feedback. They<br>can, as you say, edit the pages and add their questions / suggestions<br>directly in the page. But what will a page look like if 20 users have<br>added questions / suggestions for improvement on it?<br><br>Again: I'm not talking about user who can contribute with information<br>(having know-how), but about new users who want to use/configure<br>FreeSwitch (like new users).<br><br>There are a section on the first page called "Community and Support"<br>on the first page which tells the user how to get help. Maybe there<br>should also be a section called "How to give feedback" too?<br><br><br>On 9/20/07, Trixter aka Bret McDanel <trixter@0xdecafbad.com>
wrote:<br>> On 9/20/07, Jonas Gauffin <jonas.gauffin@gmail.com> wrote:<br>> > Ahh.. My mistake. I searched for both "FAQ" and "Frequently asked<br>> > questions" without getting a hit.<br>> ><br>><br>> The searching on that site is admittedly a bit weak, I do not know<br>> what to do about that, nor do I have any control over that since its<br>> the people that have direct control of the site. I will talk to<br>> someone and see if there is anything they can do in that regard.<br>><br>><br>> > Then I saw this in the documentation guidelines: "Try to avoid FAQs".<br>> > My conclusion was therefore that it was removed. But I found it now =)<br>> ><br>><br>> The 'try to avoid faqs' in the guidelines refers to documenting a<br>> module or something else. If you were to document mod_something there<br>> shouldnt be a need for a FAQ about that module, since
the<br>> documentation should explain what it does and how to use it. If you<br>> feel the need for a FAQ on mod_something then perhaps the<br>> documentation itself should be extended to answer those questions. :)<br>><br>><br>><br>> > My point was that people who can't contribute with information should<br>> > be able to REQUEST information. Those requests shouldn't be added in<br>> > the documentation, but in the Talk pages or special request pages<br>><br>> I dont understand, they have to edit a wiki page to request<br>> information or add to the talk section, but they cant edit a different<br>> wiki page to actually create documentation? Almost seems like its an<br>> extra layer of stuff that people would have to actively seek out to<br>> read and then update the documentation just to create this process.<br>><br>> Why cant people contribute to the documentation
effort but could<br>> contribute to wiki pages on the same system?<br>><br>><br>><br>> ><br>> > I created the documentation guidelines page too :) But that's for ppl<br>> > that can actually contribute in the documentation. Not for ppl that as<br>> > missing or not understanding some documentation.<br>> ><br>><br>> everyone can contribute, you make it sound like only some people are<br>> allowed and others cant. Maybe that is my misunderstanding when you<br>> constantly refer to people who cant edit documentation but can edit<br>> some other page on the wiki.<br>><br>> I just dont understand why this extra layer is a good thing, if people<br>> can add to those pages they can add to the documentation itself.<br>> There is a list of missing documents, which I periodically update, as<br>> well as a list of empty pages which I update at the same time. If<br>>
someone were to link to a page that doesnt exist, during the<br>> generation of the PDF I would see that and be able to edit that list,<br>> thus forming a 'weak spot in the documentation' list, which currently<br>> is there, on the main documentation page.<br>><br>><br>><br>> --<br>> Trixter <a target="_blank" href="http://www.0xdecafbad.com">http://www.0xdecafbad.com</a> Bret McDanel<br>> Belfast +44 28 9099 6461 US +1 516 687 5200<br>> <a target="_blank" href="http://www.trxtel.com">http://www.trxtel.com</a> the phone company that pays you!<br>><br>> _______________________________________________<br>> Freeswitch-users mailing list<br>> Freeswitch-users@lists.freeswitch.org<br>> <a target="_blank"
href="http://lists.freeswitch.org/mailman/listinfo/freeswitch-users">http://lists.freeswitch.org/mailman/listinfo/freeswitch-users</a><br>> UNSUBSCRIBE:<a target="_blank" href="http://lists.freeswitch.org/mailman/options/freeswitch-users">http://lists.freeswitch.org/mailman/options/freeswitch-users</a><br>> <a target="_blank" href="http://www.freeswitch.org">http://www.freeswitch.org</a><br>><br><br>_______________________________________________<br>Freeswitch-users mailing list<br>Freeswitch-users@lists.freeswitch.org<br><a target="_blank" href="http://lists.freeswitch.org/mailman/listinfo/freeswitch-users">http://lists.freeswitch.org/mailman/listinfo/freeswitch-users</a><br>UNSUBSCRIBE:<a target="_blank" href="http://lists.freeswitch.org/mailman/options/freeswitch-users">http://lists.freeswitch.org/mailman/options/freeswitch-users</a><br><a target="_blank"
href="http://www.freeswitch.org">http://www.freeswitch.org</a><br></div></div><br></div></div><br>
<hr size=1>Be a better Globetrotter. <a href="http://us.rd.yahoo.com/evt=48254/*http://answers.yahoo.com/dir/_ylc=X3oDMTI5MGx2aThyBF9TAzIxMTU1MDAzNTIEX3MDMzk2NTQ1MTAzBHNlYwNCQUJwaWxsYXJfTklfMzYwBHNsawNQcm9kdWN0X3F1ZXN0aW9uX3BhZ2U-?link=list&sid=396545469">Get better travel answers </a>from someone who knows.<br>Yahoo! Answers - Check it out.
</body></html>