Hi, > It would be very useful to provide a link to Yannick's documentation in > the Ubuntu docs.
I don't like this idea very much, because, the Ubuntu documentation will be translated but the link you will provide will remain in english. Most Ubuntu users like having their stuff in their own langage. My hope is to have my documentation in the wiki to be translated in the other Ubuntu wikis. I keep it synced (more or less) with the french Ubuntu wiki. > However, I'd advise against including all of it in the > system docs because it's very in-depth; it's probably best to leave > large, extended guides such as this on the wiki. Including Yannick's > guide would virtually replace the Ekiga documentation we ship! You're right, it's in-depth and it was intented to. The process I used to build it was to offering my support to users in forums, irc, ... It was written based on feddback. I can say most of it (if not all) is really made to help solving actual issues with Ekiga. The work of documenting the software itself in a very large way is done in wiki.ekiga.org where I (and others :) try to cover *every* aspects of Ekiga working hand in hand with upstream. As a consequence of this methodology, I would say 95% of the wiki documentation cover subjects you *won't* find in the manual shipped with Ekiga. I've just copy some informations to help people getting started from the manual (the short version of the first assistant, the how to purchase the default commercial provider and how to dial phone numbers with it, but that's mostly all I've copy). To be clear, title 3. Ekiga.net services (free calls PC-to-PC) and title 5. Configuration are not covered at all by the manual. (title 4. Register to a commercial VoIP provider (landline and mobile phones) has only the default provider covered) Thus you can take most of it, as I stated in a previous comment, without having the informations provided being a replacement for the manual you will ship with Ekiga. > > If there are specific troubleshooting issues which people have with > Ekiga, however, it might be worth including a short topic on those in > the system docs. > >From there, you can take 2 paths (and a middle term at will): 1- taking the most of my wiki documentation (see my previous comment to see what exactly is worth it) 2- taking just the more needed. In this second option, I would say people really need to know the interoperability ( title 1. Desktop interoperability) The link to the wiki there, even in english, is worth it in my opinion because it list exactly what you can expect from a communication between Ekiga and another softphone. This is really what people wants to know. I used colors and images in a table to make simple to read, hopefully even if you don't know english. Title 2. First use, is what the Ubuntu documentation tries to cover, if I get it correctly: howto get the software just work. If you compare it with the manual, you'll see the manual don't cover the test number of ekiga.net sip:[EMAIL PROTECTED] (e.g: see this bug report: https://bugs.launchpad.net/bugs/47717). Plus, it insist on the sip:address, what is people should take care if anything else goes right. In the wiki I provide a link to a step-by-step for the druid, but this is fully covered by the manual (the online documentation gives more work around in case of trouble, but the manual is translated and the online documentation is not. Thus I think the manual is better in this case. Is it possible to link to the relevant part of the manual instead ? (I think the title is "First use" in the yelp based manual, title II.) Title 3. Ekiga.net services (free calls PC-to-PC) is usefull, but if you want it short I think you can skip it. Title 4. Register to a commercial VoIP provider (landline and mobile phones) should be covered for the default provider: in the spirit of having something that just work you can copy it, or link to the manual, title III.I.II. Title 5. Configuration covers most issues people have when things goes not right after the druid. It's worth including it, but if you want things short and don't want to bother people with issues in the official documentation, just skip it. Title 7. Development snapshots is worth for upstream to have "beta testers". The packages there are very well done by the Debian maintainer of Ekiga kilian Krause, thus they won't give any trouble and they install nearby the stable release. If you're willing to help upstream, you can add this part ;) But this clearly is for power users able to report valuable bugs. Regards, Yannick -- Me joindre en téléphonie IP / vidéoconférence ? sip:[EMAIL PROTECTED] Logiciel de VoIP Ekiga : http://www.ekiga.org http://wiki.ekiga.org/index.php/Which_programs_work_with_Ekiga_%3F -- Instant messaging documentation doesn't cover useful topics https://bugs.launchpad.net/bugs/128384 You received this bug notification because you are a member of Ubuntu Bugs, which is the bug contact for Ubuntu. -- ubuntu-bugs mailing list [email protected] https://lists.ubuntu.com/mailman/listinfo/ubuntu-bugs
