Re: Confluence Usage

Subject: Re: Confluence Usage
From: Robert Lauriston <robert -at- lauriston -dot- com>
To: Sharon Metzger <sharon -dot- metzger -at- gmail -dot- com>, TECHWR-L Writing <techwr-l -at- lists -dot- techwr-l -dot- com>
Date: Tue, 14 Jul 2015 11:58:16 -0700

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>
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 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


Follow-Ups:

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

Previous by Author: Re: Confluence Usage
Next by Author: Re: Confluence Usage
Previous by Thread: Re: Confluence Usage
Next by Thread: Re: Confluence Usage


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


Sponsored Ads