RE: integrating authored content with generated API docs

Subject: RE: integrating authored content with generated API docs
From: "Mark Baker" <mbaker -at- analecta -dot- com>
To: "'Robert Lauriston'" <robert -at- lauriston -dot- com>, "TECHWR-L Writing" <techwr-l -at- lists -dot- techwr-l -dot- com>
Date: Sat, 28 May 2016 14:42:52 -0400


> The challenge in importing anything beyond a single page into
> Confluence is preserving the cross-references.

Could be, depending on how links are stored internally and whether or not
you can specify the name of a page when you create it. It you need to use an
ID assigned by the system then one approach would be to create all the pages
blank, get their IDs and then update them with the links updated to use the
provided IDs. More than just an bit of XSLT required to do that, but not
rocket science.

Then again, some systems do put up barriers, so you don't know for sure
until you try. It is possible with many tools. Can't say for sure about all.

Mark

^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Visit TechWhirl for the latest on content technology, content strategy and content development | http://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


Follow-Ups:

References:
integrating authored content with generated API docs: From: Robert Lauriston
RE: integrating authored content with generated API docs: From: mbaker
Re: integrating authored content with generated API docs: From: Robert Lauriston
Fwd: integrating authored content with generated API docs: From: Robert Lauriston
Re: integrating authored content with generated API docs: From: Robert Fekete
Re: integrating authored content with generated API docs: From: Tom Johnson
RE: integrating authored content with generated API docs: From: mbaker
Re: integrating authored content with generated API docs: From: Robert Lauriston
RE: integrating authored content with generated API docs: From: Mark Baker
Re: integrating authored content with generated API docs: From: Robert Lauriston

Previous by Author: RE: integrating authored content with generated API docs
Next by Author: Request for comments on my Structured Writing series
Previous by Thread: Re: integrating authored content with generated API docs
Next by Thread: Re: integrating authored content with generated API docs


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

Sponsored Ads


Sponsored Ads