Concept Development
I translate complex product ideas into clear explanations of what a feature does, how it works, and why it matters. By connecting technical details to familiar concepts and real-world needs, I help users build understanding, make informed decisions, and use product capabilities with confidence.
Content Management and DITA Basics
The conceptual content that I developed under Learning the OAK Foundation and Oxygen basics in the Authoring with OAK Foundation and Oxygen guide includes information that is foundational to using the Oracle Authoring Kit (OAK) Foundation content management tool to author content in DITA.
1 Learning the OAK Foundation and Oxygen basics
What is OAK Foundation?
Repository features
Key product features
Content development workflow
The OAK Foundation authoring environment
What are the OAK Foundation components?
Publication creation
Publication editing
Publication release
Publication preparation
What is a root map?
What root maps do
Why setting the map context is important
Why having the root map open is important
What is a publication?
What publications do
What happens when you open a publication
Why and how often to open publications
What is the publication baseline?
How versions are managed in the publication baseline
How and when the publication baseline is updated
What the Baseline submap does
How the root map, publication, and baseline work together
Why root maps and publications depend on one another
What's the difference between a root map and a publication baseline
What is local storage?
How content references enable the reuse of parts of a topic
How content references work and when to use them
How keys work in content references
How variables enable the reuse of varying phrases
How variables work and when to use them
How keys work in variables
How keys work in DITA
How conditions enable the reuse of content variations
Which conditional expressions can be defined and how they are evaluated
How the DITAVAL file controls which conditions to include
What the Conditions Subject Scheme map does
How to reuse topics
How to manage content using workflow statuses and versions
What are the workflow statuses and how they work
What is the difference between a version and branch and how they work
When to branch
What is a revision and how revisions work
Strategies for organizing content in folders
Strategies for organizing content in root maps
Strategies for chunking topics
Which level to chunk at
How to code chunks
Strategies for structuring navigation
Why use a flat navigation structure
Ways to flatten the navigation structure
When to use automatically generated links
How the Content Page navigation works
Where chunked topics appear
What appears in the On This Page navigation
The styling of the PDF content is defined by an Oracle template. You might also see pagination or styling issues as this content was designed to appear in HTML format in a web portal.
Article Content Type and Tooling
The conceptual content that I developed under Learning the articles and article catalog basics in the Authoring Articles with Catalog Manager guide describes the custom article content type and features. The interface of this custom tool was so poor that I had to explain it within the product content.
1 Learning the articles and article catalog basics
What's an article?
What's an article catalog?
What are catalog versions and when to version an article catalog?
What are article filters?
Which filter metadata can be assigned to article publications?
How is filter metadata assigned and how is it applied to article publications?
When to build articles and the article catalog and what gets built
Working in the Catalog Manager Tool
Catalog Product and Release
Save the Catalog
Catalog Context Menu
Catalog Title
Catalog Information
Catalog Tree
Catalog Workspace
Tree Context Menu
Article Context Menus
The styling of the PDF content is defined by an Oracle template. You might also see pagination or styling issues as this content was designed to appear in HTML format in a web portal.