[Freeswitch-docs] Confluence quirks

[Bote Man]

Sorry, Jim. I just rolled back home from ClueCon so I've been out of the
loop. I hope you asked this on the freeswitch-docs mailing list as the
others might have ideas.

 

Macros

Yeah, I created the 'fc' macro as a shortcut. I have mixed feelings on
the code styling. I really, really, REALLY do not get dark blue text on
a black background; who in the world thought that would be a good idea?
That's the friggin default for common elements shown by LS_COLORS on
most linux distros and apparently Confluence uses it liberally. Go
figure.

 

Overall I'm trying to lend a consistent style so that Confluence looks
like real documentation and not the mish-mash that the old MediaWiki
became with everybody doing his own thing. if it looks good, do it.

 

Editor

Atlassian likes to crow about how reliable the Confluence editor is.
Yeah, right. It frequently does weird stuff for me. My best advice is to
get all the text onto the page first, then go back and style it. Moving
tables and other macro elements around typically results in shenanigans.
L

 

I used Compare Versions successfully recently. It could be that it
didn't have a proper earlier version to use as a datum for comparison,
but that's just a guess.

 

I'm digging out from under all these e-mails and whatnot that have piled
up in my 2 week absence, so thanks for your efforts!

 

Bote

 

 

 

From: Jim Hayes [mailto:jhayes at jhayes.org] 
Sent: Thursday, 31 July, 2014 00:01
To: Bote Man; William King
Subject: Quick check-in

 

 

So I’ve been slowly working my way through the XML dialplan page,
turning it into something that I would have liked to have read when I
brought up my first system.

 

Can you look at what I’ve done so far and make sure I’m not on the wrong
track?

 

Issues I’ve encountered so far:

*	The {fc macro doesn’t let me configure anything other than the
“Caption”.  So when I try to set it to emacs mode or turn on XML
formatting (it really does make the code more readable, IMHO) I have to
switch to the Confluence code macro, losing the Caption field.  Which
should I use?  What are the benefits of the “Caption” field?
*	Mysteriously, all of my example text disappeared last night
while I was messing with a table position in the middle of the doc.
Seen that before?
*	The compare versions feature doesn’t seem to work for me.  It
either gives me an error or tells me that the compare process took more
than 30 seconds.  Is this a known issue?

 

Anyway, I should be finished in a couple of days.  It’s a long slog
through that stuff. :-)

 

-Jimbo

 

 

 

 

-------------- next part --------------
An HTML attachment was scrubbed...
URL: http://lists.freeswitch.org/pipermail/freeswitch-docs/attachments/20140811/70e1e2ca/attachment.html