Recent searches
No recent searches

Laura Rubin
Joined Oct 22, 2021
·
Last activity Oct 22, 2021
Following
0
Followers
0
Total activity
2
Votes
0
Subscription
1
ACTIVITY OVERVIEW
BADGES
ARTICLES
POSTS
COMMUNITY COMMENTS
ARTICLE COMMENTS
ACTIVITY OVERVIEW
Latest activity by Laura Rubin
Laura Rubin created a post,
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