RE: Confluence Usage

Subject: RE: Confluence Usage
From: "Sharon Metzger" <sharon -dot- metzger -at- gmail -dot- com>
To: "'John G'" <john -at- garisons -dot- com>, "'Robert Lauriston'" <robert -at- lauriston -dot- com>
Date: Tue, 14 Jul 2015 15:17:49 -0400

Oh, I can do nested lists (and for that matter, I can do it in raw HTML in the source editor if the WYSIWYG editor is stubborn), but if a list item has more than one paragraph or a supporting image, and other complexities creep in, it can get ugly quickly. The spacing between items, the correct numbering and hierarchy, aligning the sublists and maybe images with the bullet indentationâ



Otherwise, itâs great ;-)



Sharon



From: vwritert -at- gmail -dot- com [mailto:vwritert -at- gmail -dot- com] On Behalf Of John G
Sent: Tuesday, July 14, 2015 3:12 PM
To: Robert Lauriston
Cc: Sharon Metzger; TECHWR-L Writing
Subject: Re: Confluence Usage



As Robert explains, there are ways to format just about everything in Confluence... but they're not always evident or easy to figure out. I have numbered lists with two levels of embedded bulleted lists as well as embedded a, b, c lists that containing bulleted lists.

Once you figure it out, it's pretty easy to use.



My 2Â,

JG





On Tue, Jul 14, 2015 at 2:58 PM, Robert Lauriston <robert -at- lauriston -dot- com <mailto:robert -at- lauriston -dot- com> > wrote:

I spent a LONG time trying to get native PDF output that looks as good as
Atlassian's. They won't share their secrets.

https://answers.atlassian.com/questions/185951/documentation-pdf-export-a-la-atlassians

If someone has a publicly accessible Confluence instance, I could post my
macros and workarounds. I've posted most if not all on the confluence_tw
Yahoo group.

Nesting a bullet list within a numbered list:


- press enter at the end of the numbered paragraph after which you want
the bullet list to appear
- type something as a placeholder
- go back to the end of the previous paragraph and press enter again
- click Indent > Bullet List


On Tue, Jul 14, 2015 at 10:56 AM, Sharon Metzger <sharon -dot- metzger -at- gmail -dot- com <mailto:sharon -dot- metzger -at- gmail -dot- com> >
wrote:


> I've been using Confluence since November. We currently deliver PDFs only.
> It was here when I got here, and has had a series of (now moved-on) tech
> writers working on various versions and various templates.
>
> Our software shop uses lots of Atlassian tools (Jira, Stash, HipChat, etc),
> so the fact that all the tools play well together is attractive.
>
> Built-in PDF export is challenging. Your CSS savvy will be stretched, and
> there's still some black magic under the covers. I'm currently working on
> templates for the Scroll PDF Exporter (eval version), but that seems to
> have
> different quirks than the built-in PDF, so the jury's still out.
>
> Our engineers and sales/product folks use it extensively for an internal
> wiki. (design docs, release plans, roadmaps, customer wish lists, general
> how-tos, and the like). They've gotten much better at posting things since
> I've jumped in as an active curator -- customizing the dashboard, archiving
> obsolete pages, generally making it easier to find what's current, etc.
>
> They also like collaborating and commenting on the doc sources. I was
> nervous about the collaboration (that engineers would go in mucking up all
> my carefully crafted professional-writer work), but for the most part, they
> use the page and inline comment features and don't edit "my" sources. They
> also like the Comala Workflows plugin I've implemented for review cycles
> and
> signoffs.
>
> So, with caveats, it's working for us. I still miss Frame (which I lived in
> for 15-20 years) and would love to get a chance to learn Flare. There are
> enough quirks in Confluence's WYSISometimes/SortaWYG (agree on the
> necessity
> of the source editor) and PDF production to make me hold back on a
> wholehearted recommendation. Lists and nested lists are my nemesis. As are
> pagebreaks. But then, there's a whole community of folks out there who
> love
> it and think it's the best thing since spell-check. I haven't found the
> Kool-Aid yet, but it's hard to say where to draw the line between my still
> less than expert knowledge and Confluence's real limitations.
>
> FWIW,
> Sharon
>
> PS -- Robert -- I suspect I'd be interested in your pagebreak
> macros/pointers. And thanks for your comments about Scroll HTML exporter vs
> Confluence web delivery.
>

^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Learn more about Adobe Technical Communication Suite (2015 Release) | http://bit.ly/1FR7zNW

^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

You are currently subscribed to TECHWR-L as vwritert -at- gmail -dot- com <mailto:vwritert -at- gmail -dot- com> .

To unsubscribe send a blank email to
techwr-l-leave -at- lists -dot- techwr-l -dot- com <mailto:techwr-l-leave -at- lists -dot- techwr-l -dot- com>


Send administrative questions to admin -at- techwr-l -dot- com <mailto:admin -at- techwr-l -dot- com> . Visit
http://www.techwhirl.com/email-discussion-groups/ for more resources and info.

Looking for articles on Technical Communications? Head over to our online magazine at http://techwhirl.com

Looking for the archived Techwr-l email discussions? Search our public email archives @ http://techwr-l.com/archives



^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Learn more about Adobe Technical Communication Suite (2015 Release) | http://bit.ly/1FR7zNW

^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

You are currently subscribed to TECHWR-L as archive -at- web -dot- techwr-l -dot- com -dot-

To unsubscribe send a blank email to
techwr-l-leave -at- lists -dot- techwr-l -dot- com


Send administrative questions to admin -at- techwr-l -dot- com -dot- Visit
http://www.techwhirl.com/email-discussion-groups/ for more resources and info.

Looking for articles on Technical Communications? Head over to our online magazine at http://techwhirl.com

Looking for the archived Techwr-l email discussions? Search our public email archives @ http://techwr-l.com/archives


References:
Confluence Usage: From: Laura Phillips
Re: Confluence Usage: From: John G
RE: Confluence Usage: From: Sharon Metzger
Re: Confluence Usage: From: Robert Lauriston
Re: Confluence Usage: From: John G

Previous by Author: RE: Confluence Usage
Next by Author: RE: Inland Empire interview attire
Previous by Thread: Re: Confluence Usage
Next by Thread: Re: Confluence Usage


What this post helpful? Share it with friends and colleagues:

Sponsored Ads


Sponsored Ads