Space Details:

Key	DBP
Name	DITA Best Practices
Description	A collection of best practices for authoring in oXygen and DITA!
Created by	Kel Mankenberg (Jul 22, 2013)

Available Pages:

DITA Best Practices Home
- New to oXygen and DITA?
  - Concepts
    - Using Section elements
    - Using Notes in a Concept
    - Using paragraph elements
    - Concept examples
  - Tasks
    - Task examples
    - Using Notes in a Task
  - References
    - Reference example
  - Identifying the Information Type
  - The case for using DITA
    - Minimum DITA Adoption Overview
- Setup and Configuration
  - Setting Up DITA-OT
  - Importing Transformation Scenarios into oXygen
  - Edit DITA scenario - Parameters
  - DITA fo2 shell tw
  - Setting up Profiling Sets
  - Creating attribute values
  - Maintenance: downloading the Oxygen 17.0 webkit
  - How to display the WKFS GRC Authoring Styles
- Using oXygen
  - The oXygen interface - Overview
    - Author Mode
    - oXygen Views
      - Attributes view
      - DITA Maps Manager view
      - Project view
      - Transformation Scenarios view
      - Using the DITA Maps Manager View
      - Using the Project View
    - Text Mode
    - The oXygen Menus
    - The oXygen Toolbar options
  - Creating new topics (information types)
    - Creating a concept
    - Creating a reference
    - Creating a task
  - Modifying Metadata
  - User Preferences/Helpful Tips
    - Changing your Tags Display mode
    - Using breadcrumbs in oXygen
    - Using the Comment feature
  - Attributes
    - Product Attributes
      - Configuring oXygen to work with multiple product attributes
      - Applying your product attribute to existing topics
      - Creating or Modifying Product Attributes
      - Product Attribute Quick Reference
    - Profiling Attributes: turning on/off
    - Applying Profiling Attributes
  - Content References (conref)
    - Project Names ConRef
  - DITA map (ditamap)
    - Create a DITA map
    - Add references to a DITA map
    - Using attributes in a DITA map
  - General Authoring Guidelines
    - File naming convention
    - Turning element and attribute tags on/off
  - Images
    - Images Best Practices - CMS/DITA XML Usage
    - Working with images
  - Links
    - Creating a link to an external file on the web
    - How to Remove Related Links
    - Linking attribute
    - Using Cross References
  - Using Lists
    - Creating a bulleted list in a concept
    - Creating a bulleted list in a task
    - Creating a Ordered List <ol/> in a Concept and Task
    - Using a Task to create a numbered list (Using <Steps/>)
  - Using Tables
    - Tables Overview
  - Using Notes
  - Block Elements
  - Phrase/Inline elements
  - Inserting elements using oXygen
  - Indexes
    - Using Indexes - Best Practices
    - How to Add Index Items to Topics
  - Turning off the Review (track changes) feature
- Publishing from oXygen
  - Transformations
    - Transformation Scenarios
      - Changing the Output location in the DITA Map Webhelp - WKFS scenario
    - Uploading Content to Help Web Server
    - Using the webhelp transformation in Oxygen
  - DITAVALs
    - Creating a DITAVAL using oXygen locally
    - DITAVAL Naming Conventions
- Troubleshooting oXygen
  - Authoring troubleshooting
  - Transformation Troubleshooting Best Practices
  - Turning off non-essential information when transforming
  - Verifying the Transformation Scenario
- How-to articles
  - Create a Top FAQs/Important Message tile
  - Creating FAQ entries in an FAQ topic
  - How to Create Dynamic Profiling in Responsive WebHelp
  - How to text wrap in Oxygen for use in the Text mode
  - Insert a Google calendar in DITA content
  - Using the WKFS Author Mode Style Sheet
- Administration Procedures
  - Modifying Product Attribute Values
- Content Reuse
  - Content Reuse - Practical Applications and Best Practices
  - Reuse - Vasont error message when deleting elements from source topic
- Configuring Toolbars in Oxygen
- Transforming an Oxygen webhelp system into a compiled HTML help (CHM) system
- Release Notes and Change Log Structure
- Using Styles in Oxygen: Setting Styles View
- oXygen Customization Files/folders
- How to Display the Survey Ribbon
- How to Insert a Release Note Snippet
- outputclass and Transformations
- Restoring Archived Content to Production