Forums

Articles
Create
cancel
Showing results for 
Search instead for 
Did you mean: 

Integrating a writing tool with Confluence

i_isay October 27, 2020

Hi all! I plan to switch from Confluence to a writing tool to manage our product documentation. But I still have a lot of readers in Confluence, and I need to somehow integrate Confluence into the writing tool (or whatever to link them) to constantly update the Confluence docs from the writing tool. The writing tool producers do not support any plugins, etc. Did someone do anything like that? Does anyone experience any problem like that and what was your solution? Thanks!

1 answer

1 vote
Matt Reiner _K15t_
Atlassian Partner
October 27, 2020

Hi @i_isay

The only option I can think of is to:

  1. Export the content out of your writing tool as a Word file when you want to update the content in Confluence
  2. Delete the old documentation in the Confluence space
  3. Import the Word document

Why do you want to write in another tool?

i_isay October 27, 2020

Thank you! I'll try it that way for now..

There are several reasons:

- Track changes and update the docs or its sections with one stroke (like snippets, images)

- Manage versions

- PDF format of Confluence is a disaster! I need smth better to publish in PDF

- Need more formatting features, more like in Word

- Track broken links and fix them all together

There are many reasons why Confluence is not ok for technical writing ) It was fine for a while, but today, I have too many pages, it's simply hard to manage them.

Matt Reiner _K15t_
Atlassian Partner
October 29, 2020

Ah, interesting.

  • I suppose you can look at the Page History to see some of this, but perhaps that's not enough. You could also consider using an Inclusion Library to house your images and snippets in Confluence. I find those much easier to make changes across an entire space.
  • For managing versions, you could check out my team's app Scroll Documents. We're also working on integrating it with our app Scroll Viewport so you can quickly publish one or more versions of your content to a help center. Here's our help center as an example.
  • PDF formatting is rough, for sure. As another option, my team makes Scroll PDF Exporter, which has a full template builder you can use to make things look just the way you'd like. We just redesigned the template builder, so I'd suggest checking out the video on the listing to see it in action.
  • Formatting is certainly limited in the new Cloud Editor. I'm glued to the roadmap. You might find some of the theming provided by Scroll Viewport makes up for this, or perhaps not.
  • Some link checking is done when generating a preview in Scroll Viewport.

While we don't have a massive amount of pages, we've been using these tools and techniques for a while now. Hope this is helpful.

Like # people like this
i_isay October 29, 2020

These are interesting things you say! I'll check them out! Thanks! 

Like # people like this

Suggest an answer

Log in or Sign up to answer
DEPLOYMENT TYPE
CLOUD
PRODUCT PLAN
STANDARD
PERMISSIONS LEVEL
Product Admin
TAGS
AUG Leaders

Atlassian Community Events