Important things to know

Introducing IXIASOFT CCMS Web to teammates

When you introduce IXIASOFT CCMS Web to your subject matter experts or reviewers, take some time to point out the editing or reviewing tools that you expect them to use. The interface contains a number of features that are intended for a range of users, from those who have little to no knowledge of markup languages to those who are familiar with HTML, XML, or even DITA. By focusing them on what you want them to use, you can alleviate the trepidation of learning a new tool (and perhaps prevent eager users from hunting for the elements and attributes to produce the formatting they want instead of focusing on providing the content).

Since each company's workflow is different, you should also explain when and how you want your subject matter experts and reviewers to check in the content assigned to them. Do you want them to change the status of the topic at check in? Do you want to use the Mark as Finished?

Choose assignments wisely

When you decide which topics to assign, remember the knowledge level of the person who will be working on the topic. The oXygen XML Web Author Component on the Editing page in IXIASOFT CCMS Web has been customized by IXIASOFT by default to camouflage the complexity of DITA to allow users to work on the content in a simplified, user-friendly environment. For example, some elements in the topic are not displayed in the Editing page or made read-only to avoid overwhelming users. Assigning a topic that contains a complex use of DITA elements may be too difficult for someone unfamiliar with DITA or XML to edit. For example, a topic containing a lot of conditional text may be confusing to work on since they may not understand the concept of conditional text. In addition to the default customizations in the oXygen XML Web Author Component, your system administrator may have integrated other customizations according to your company's needs.

Avoid entities in your topics