[Freeswitch-docs] Inconsistency in mod_dptools pages

[Bote Man]

I started to simplify the page names under mod_dptools and only made it as
far as you currently see them listed. I was reluctant to resume the process
until I got consensus that this is the desired approach, as the page name
becomes the hyperlink to that page. Confluence is supposed to update
internal links between pages when the page name changes, but I have seen a
few odd cases where it did not.

Also, when page names contain special characters Confluence creates a
numeric hyperlink to the page instead of the recognizable link containing
the text name of the page, so the preference is always to avoid special
characters in page names.

I was adding the "excerpt" macro to the About section of the child pages so
that its contents would also appear in the macro on the parent page that
lists all the child page names, but the text inside the excerpt should be
kept short for this reason. When the excerpt is configured to be "inline" it
looks just like part of the sentence on the page so it can serve two
functions.

So I would just use the short "friendly" page name for record_session.

Thanks for pointing this out.

Bote


-----Original Message-----
From: Stanislav Sinyagin
Sent: Tuesday, 17 February, 2015 17:25
Subject: [Freeswitch-docs] Inconsistency in mod_dptools pages

hi,

If you look at the children list of
https://freeswitch.org/confluence/display/FREESWITCH/mod_dptools
you see that there are two ways of naming the pages:

1. By command name, like "detect_speech"
2. Long space-delimited name, like "mod_dptools: Dialplan Tools record
session"

What is the correct way of naming and linking pages? I guess it's #1, but
I'm new to this Confluence, so I better follow some common standard.

Also,
https://freeswitch.org/confluence/display/FREESWITCH/record
has a broken link to "record_session" -- I guess I can modify it to refer to
the Confluence page, as soon as the first question is resolved, right?


cheers,
stan

_______________________________________________
Freeswitch-docs mailing list
Freeswitch-docs at lists.freeswitch.org
http://lists.freeswitch.org/mailman/listinfo/freeswitch-docs