Recent searches


No recent searches

Laura Rubin's Avatar

Laura Rubin

Joined Oct 22, 2021

·

Last activity Oct 22, 2021

Following

0

Followers

0

Total activity

2

Votes

0

Subscription

1

ACTIVITY OVERVIEW

Latest activity by Laura Rubin

Laura Rubin created a post,

Post Feedback - Help Center (Guide)

We're working on providing both per-page help content for our app, but we also want to be able to provide workflow-based documentation.  To that end, I'm surprised that the Help Center doesn't allow for any reusable content.

What I'm requesting is similar to the "include" or "transclude" syntax in wikis - there's a pretty good Atlassian doc page about what I'm asking about: https://confluence.atlassian.com/display/DOC/Excerpt+Macro  This same feature is available in FrameMaker as "insets", and they're really important for working with highly structured documentation.

In a single-source environment, you mark a section of text from Page A as reusable, and basically set a URL that can be called to invoke the part you've marked for re-use. When you add a reference to that content in Page B, it displays the Page A content (usually) wrapped in the Page B content.

So for example I have a Help Center topic about what to do if you lose your card. There are a couple of other situations when you'd do exactly the same thing as if you'd lost your card, so I want to mark that procedure as reusable, and include it in the help center topics for those other situations. This way if, for example, the "freeze my card" help phone number included in that process changes, I only have to update it in one place, and not go hunting across the entire help center for any reference to that number.

Posted Mar 18, 2015 · Laura Rubin

30

Followers

32

Votes

33

Comments