Re: Tools

Subject: Re: Tools
From: Nina Barzgaran <nina -dot- barzgaran -at- barzgaran -dot- at>
To: techwr-l -at- lists -dot- techwr-l -dot- com
Date: Sat, 7 Nov 2020 18:10:21 +0100

Hi All,

fascinating, how different the outlook is for people.

One thing is certain:
* Confluence is neither 'good' or 'bad' taken on its own.

**It depends on your setup and use case!**

If you are a tech writer with only some experience with large bodies of documentation, say, over 1000 pages (Confluence count), with requirements as regards output, possibly even bundling documentation with a software product at build time, you will know what others before me also put nicely and concisely: Confluence quickly reaches its limits.

*You have to do tests and actually find toolchains that fit your environment.*

I worked both with larger developer teams (30) and with smaller ones (5-15).
We did not use developing documentation directly. We had collaboration with SMEs, though. There are all kinds of collaboration features either included in professional Help Authoring Tools or you can import simple document formats like Word into them without much effort.

But as soon as the requirements for output and documentation versioning, for example, managing content in one place and yet output to the most common formats these days, such as DITA, ebook or even PDF are requirements, Confluence will quickly hit its limits.
I know the Scroll plugins, but the same applies here:

Define proper requirements - and test.

Regards
Nina

Am 05/11/2020 um 00:00 schrieb Syed Zaeem Hosain:

Ah, I had not thought that editing the source for the page.

A bit of a "roll my eyes" thing to have to edit the HTML for limitations in the Confluence editor ... but ... I will try it.

Thanks,

Z

-----Original Message-----
Robert Lauriston said:
You need a source editor plugin. Then you can fix the underlying table HTML. I use that around once a month to fix table rows with an extra or missing cell.
free for Server:
https://marketplace.atlassian.com/apps/1210722/confluence-source-editor
paid for Cloud:
https://marketplace.atlassian.com/apps/1215664/source-editor-for-confluence
On Mon, Nov 2, 2020 at 10:15 AM Syed Zaeem Hosain <Syed -dot- Hosain -at- aeris -dot- net> wrote:
... We have struggled with pages where people 'accidentally' split tables into more than one table. Without any [apparent] way to recombine them (I have done this myself, so cannot blame others too much).

If you don't catch the error in time, then the only way to fix the issue is to drop all the changes since the last publish, revert to an earlier version of the page, and try again!

And, I have yet to figure out (I guess I am not using Confluence tables enough) _what_ we do to cause the table split in the first place.
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Visit TechWhirl for the latest on content technology, content strategy and content development | https://techwhirl.com

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

You are currently subscribed to TECHWR-L as nina -dot- barzgaran -at- barzgaran -dot- at -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

--
Nina Barzgaran, M.A.
Technical Communicator
Linzer StraÃe 434-436/3/23
1140 Wien
Ãsterreich

^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Visit TechWhirl for the latest on content technology, content strategy and content development | https://techwhirl.com

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

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

Previous by Author: Re: Visual Insertion Order (Ticketing) System
Next by Author: Re: Knowledge Bases -- What are they, really?
Previous by Thread: RE: Best ebook software or method for a 250-page book from PDF to Kindle
Next by Thread: Content Management ... was RE: Tools


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


Sponsored Ads