[Freeswitch-docs] Conference Page

[Ítalo Rossi]

-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 at 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 at lists.freeswitch.org [mailto:freeswitch-
> > docs-bounces at 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 at 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 at sip2sip.info
> > xmpp: jungle-boogie at jit.si
> >
> > _______________________________________________
> > Freeswitch-docs mailing list
> > Freeswitch-docs at lists.freeswitch.org
> > http://lists.freeswitch.org/mailman/listinfo/freeswitch-docs
>
>
> _______________________________________________
> Freeswitch-docs mailing list
> Freeswitch-docs at lists.freeswitch.org
> http://lists.freeswitch.org/mailman/listinfo/freeswitch-docs
>



-- 
Ítalo Rossi
-------------- next part --------------
An HTML attachment was scrubbed...
URL: http://lists.freeswitch.org/pipermail/freeswitch-docs/attachments/20150717/3fcf9839/attachment-0001.html