-1 for Duplication. What we probably want is that every code example must have an 'example' tag in it, so we can easily find all the examples using the tag browser (https://freeswitch.org/confluence/label/FREESWITCH/examples ). We should really talk about which items should be in the main root tree, there's some odd things that I really dislike and give others an impression that things is not well organized. A good example is that we have the Configuring section and if you look at the bottom you'll see "Configuration OpenZAP - DigiumTDM400P Example". This page should be under the Configuring section and probably a sub section of TDM Cards, or something like that. That's just an example. Another one is https://freeswitch.org/confluence/display/FREESWITCH/Creating+RPM+repositary . I also would remove Index, Corrections and Old Wiki and Release Process from the main tree and put them in they appropriate section. We need to 'refactor' the first page with a new user perspective, what they need to know first and what's the best flow to learn FreeSWITCH? Just thoughts... On Fri, Jul 17, 2015 at 11:31 AM, Bote Man <bote_radio@botecomm.com> wrote:
Duplication is the enemy.
It's too easy for an example on one page to be updated while another example is forgotten or worse, modified separately with no version control to keep the duplicates in sync.
I haven't finished what I started on the original conference page because the latest FS release is focused so heavily on video conferencing that there are tons of changes associated with that whole module and Mike and others wrote extensive changes to the docs for it.
Bote
-----Original Message----- From: freeswitch-docs-bounces@lists.freeswitch.org [mailto:freeswitch- docs-bounces@lists.freeswitch.org] On Behalf Of jungle Boogie Sent: Friday, 17 July, 2015 10:16 To: FreeSWITCH Docs Team Subject: Re: [Freeswitch-docs] Conference Page
On 9 July 2015 at 22:33, Stanislav Sinyagin <ssinyagin@gmail.com> wrote:
yes, looks odd where it is now. There's also a separate section with examples, https://freeswitch.org/confluence/display/FREESWITCH/Examples so we can place them there, and link from mod_conference
IMO, an entire page for examples is a good idea. The examples may be duplicated in both the article about the example and in it's own section, but if there's one place users can go to get a good example, that's good.
-- ------- inum: 883510009027723 sip: jungleboogie@sip2sip.info xmpp: jungle-boogie@jit.si
_______________________________________________ Freeswitch-docs mailing list Freeswitch-docs@lists.freeswitch.org http://lists.freeswitch.org/mailman/listinfo/freeswitch-docs
_______________________________________________ Freeswitch-docs mailing list Freeswitch-docs@lists.freeswitch.org http://lists.freeswitch.org/mailman/listinfo/freeswitch-docs
-- Ítalo Rossi