[Freeswitch-docs] mod_perl documentation

[Bote Man]

It’s automated.

 

https://freeswitch.org/confluence/display/FREESWITCH/Confluence+Wiki+Standards+and+Guidelines

 

…now has the “Labels” macro at the bottom showing all labels currently in use. Macros are one feature of Confluence that I do like, when they decide to work properly. That macro displays a larger list than

 

https://freeswitch.org/confluence/labels/listlabels-alphaview.action

 

Weird.

 

I have to say that list of labels is already getting f at ckin ridiculous.

 

We don’t need both “conference” and “conferencing”, for example. Nor “operating system” and “operating systems”. So redundancies like that should be reduced to the plural forms since labels represent a set of multiple pages.

 

I see we have 

Perl,

php

Python

Ruby

Javascript

 

So the tide is rising there. I guess that makes sense to use labels to group together the same language. Now to see if all of those language pages also has the “scripts” label. Labels are quite powerful.

 

Bote

 

 

From: freeswitch-docs-bounces at lists.freeswitch.org [mailto:freeswitch-docs-bounces at lists.freeswitch.org] On Behalf Of Stanislav Sinyagin
Sent: Saturday, 21 March, 2015 03:55
To: FreeSWITCH Docs Team
Subject: Re: [Freeswitch-docs] mod_perl documentation

 

Alright, then we need the catalogue of labels on the confluence guidelines page :)

On Mar 21, 2015 1:54 AM, "Bote Man" <bote_radio at botecomm.com> wrote:

The labels provide a means of creating a set of related pages even if each
page appears in a different part of the outline control in the pane on the
left side of the Confluence site.

It looks chaotic because there is some crossover in topics and some pages
can result in a judgment call. There is not always an obvious set of labels
for any given page.

My biggest hope is to keep the list of labels small. The last thing we need
is an "index to the index". So if it deals with Perl, Python, or Lua they
all get the "scripts" label. Clicking that label shows all pages tagged with
"scripts". I'd prefer not to have labels for specific languages and such,
unless we have such a large collection of pages for each language that it is
helpful.

The search engine is pretty decent for finding pages and text in them as
well.

I was hoping to use the "learn" label more for pages that teach newcomers
about FreeSWITCH, but we have very few articles like that. Most pages are
either listings of variables and apps or else dialplan and script examples,
so there it is.

There is still MUCH work to be done just to bring Confluence up to the
current version and to make it more useful to newcomers to eliminate a lot
of obvious questions. I have been largely absent from the effort for the
Winter, but I am coming out of hibernation now to help more. :-)

Thanks for all your efforts!

Bote


> -----Original Message-----
> From: Stanislav Sinyagin
> Sent: Friday, 20 March, 2015 19:55
> Subject: Re: [Freeswitch-docs] mod_perl documentation
>
> I also copied mod_perl examples, and marked obsolete ones for deletion.
>
> What is the supposed policy of assigning labels to articles? At the
> moment the labels look quite chaotic. If I mark all pages related to
> mod_perl with "mod_perl", "scripting", "developers" -- will it be
> right?
>
>
>
> On Fri, Mar 20, 2015 at 4:50 PM, Bote Man <bote_radio at botecomm.com>
> wrote:
> > Excellent! Thank you very much!
> >
> > And yes, there are some pages on the old wiki that are trivial
place-holders
> > and can be "deleted" rather than moved to Confluence.
> >
> > Bote
> >
> >
> >> -----Original Message-----
> >> From: freeswitch-docs-bounces at lists.freeswitch.org [mailto:freeswitch-
> >> docs-bounces at lists.freeswitch.org] On Behalf Of Stanislav Sinyagin
> >> Sent: Friday, 20 March, 2015 11:37
> >> To: FreeSWITCH Docs Team
> >> Subject: [Freeswitch-docs] mod_perl documentation
> >>
> >> hi,
> >>
> >> I updated mod_perl in Confluence, and moved most of subpages into it:
> >> https://freeswitch.org/confluence/display/FREESWITCH/mod_perl
> >>
> >> I'm not sure about the Rosetta page. It looks to me that it can be
> >> easily dropped, as it's too little informative:
> >> https://wiki.freeswitch.org/wiki/Mod_perl_Rosetta
> >>
> >>
> >> cheers,
> >> stan
> >>
> >> _______________________________________________
> >> 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
>
> _______________________________________________
> 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

-------------- next part --------------
An HTML attachment was scrubbed...
URL: http://lists.freeswitch.org/pipermail/freeswitch-docs/attachments/20150321/8a751652/attachment-0001.html