OASIS Darwin Information Typing Architecture (DITA) TC

Using DITAweb for the OASIS DITA TC's reviews of the DITA 1.3 specification Remember to download the draft for the review from https://www.oasis-open.org/committees/document.php?document_id=52371&wg_abbrev=dita Here are some tips about using DITAweb. Please note that the interface is built of window widgets that you can show or hide; you also can float them to where you want them. If you don't see a widget or have closed it and need it back, click Widget Manager . Getting started Go to ditaweb.com/oasis-dita . In the upper-right corner, click Sign In . Type your user name and password, and then click OK . Your username is your first initial followed by your last name (all lower case). I'll send out passwords to everyone off-list. In the Publications widget, expand the appropriate folder. Click the publication. The publication opens in the Content widget. Changing your password In the upper-right corner of the Web browser window, click Profile . In the Profile window, make your changes, and then click Close . Navigating around the publication You can navigate the publication in several ways: In the Contents widget, the TOC is displayed. When you click on a topic, it opens in the middle pane. In the Content widget, there are left and right arrow icons that enable you to move back and forward. In the Revisions widget, you can see a list of topics that contain a specific revision value. In the Search widget, you can see results of a search on a phrase or term. Locating content associated with a DITA 1.3 proposal In the Revisions widget, expand the revisions node. You'll see nodes that represent each value for @rev that is defined in the subject scheme map. If you expand a node, you'll see a list of the topics that contain that value for the @rev attribute. Select a topic, and it is displayed in the center pane. All DITA 1.3 revisions are highlighted in brown text (per settings in the DITAVAL file); additionally, revisions associated with the value that you selected from the Revisions widget are displayed with a tan background color. Note that completely new topics are not highlighted with either the brown text and the tan background color that DITAweb dynamically generates. Commenting on a topic There are two type of comments that you'll want to make: Comment and Change. Ignore Note. Click Enable Annotating , and navigate to the topic on which you want to comment. Click either Comment or Change . Select a block of text in the topic. A window is displayed. If you clicked Comment , it is blank; if you clicked Change , it is populated with the text that you selected. Type your comment (or edit the displayed text), and then click the Floppy disk icon. Viewing comments on a topic You can view the comments both in the Content widget and in the Annotations widget. If you are viewing a topic and have the Annotations widget open, all the comments present in the topic are displayed in the widget. You can view the comments in the Content widget. You can toggle how the comments are displayed -- whether all comments are displayed inline or whether they are just indicated by a small icon -- by clicking Show All Annotations or Hide Annotations . Show All Annotations view: Hide All Annotations view: Comment icon highlighted with red box If you have hidden the annotations, you can open a single one by clicking on the Comment icon. -- Best, Kris Kristen James Eberlein Chair, OASIS DITA Technical Committee Principal consultant, Eberlein Consulting www.eberleinconsulting.com +1 919 682-2290; kriseberlein (skype)

Remember to download the draft for the review from https://www.oasis-open.org/committees/download.php/54295/review-2-draft.zip Here are some tips about using DITAweb. Please note that the interface is built of window widgets that you can show or hide; you also can float them to where you want them. If you don't see a widget or have closed it and need it back, click Widget Manager . Getting started Go to ditaweb.com/oasis-dita . In the upper-right corner, click Sign In . Type your user name and password, and then click OK . Your username is your first initial followed by your last name (all lower case). Your password is the same as before. If you do not have a DITAweb account, contact me, and I will create an account and send your password off-list In the Publications widget, expand the appropriate folder. Click the publication. The publication opens in the Content widget. Changing your password In the upper-right corner of the Web browser window, click Profile . In the Profile window, make your changes, and then click Close . Navigating around the publication You can navigate the publication in several ways: In the Contents widget, the TOC is displayed. When you click on a topic, it opens in the middle pane. In the Content widget, there are left and right arrow icons that enable you to move back and forward. In the Revisions widget, you can see a list of topics that contain a specific revision value. In the Search widget, you can see results of a search on a phrase or term. Locating content associated with a DITA 1.3 proposal In the Revisions widget, expand the revisions node. You'll see nodes that represent each value for @rev that is defined in the subject scheme map. If you expand a node, you'll see a list of the topics that contain that value for the @rev attribute. Select a topic, and it is displayed in the center pane. All DITA 1.3 revisions are highlighted in brown text (per settings in the DITAVAL file); additionally, revisions associated with the value that you selected from the Revisions widget are displayed with a tan background color. Note that completely new topics are not highlighted with either the brown text and the tan background color that DITAweb dynamically generates. Commenting on a topic There are two type of comments that you'll want to make: Comment and Change. Ignore Note. Click Enable Annotating , and navigate to the topic on which you want to comment. Click either Comment or Change . Select a block of text in the topic. A window is displayed. If you clicked Comment , it is blank; if you clicked Change , it is populated with the text that you selected. Type your comment (or edit the displayed text), and then click the Floppy disk icon. Viewing comments on a topic You can view the comments both in the Content widget and in the Annotations widget. If you are viewing a topic and have the Annotations widget open, all the comments present in the topic are displayed in the widget. You can view the comments in the Content widget. You can toggle how the comments are displayed -- whether all comments are displayed inline or whether they are just indicated by a small icon -- by clicking Show All Annotations or Hide Annotations . Show All Annotations view: Hide All Annotations view: Comment icon highlighted with red box If you have hidden the annotations, you can open a single one by clicking on the Comment icon. -- Best, Kris Kristen James Eberlein Chair, OASIS DITA Technical Committee Principal consultant, Eberlein Consulting LLC www.eberleinconsulting.com +1 919 682-2290; kriseberlein (skype)

The following content was harvested from an e-mail I sent on 02 March 2014, when we started using DITAweb. I removed some content that was not germane for DITA 2.0 reviews, and also made some updates. Please let me know if you need any additional help! Using DITAweb for the OASIS DITA TC's reviews Here are some tips about using DITAweb. Please note that the interface is built of window widgets that you can show or hide; you also can float them to where you want them. If you don't see a widget or have closed it and need it back, click Widget Manager . Getting started Go to ditaweb.com/oasis-dita . In the upper-right corner, click Sign In . Type your user name and password, and then click OK . Your username is your first initial followed by your last name (all lower case). If you need your password reset, contact me or Robert Anderson. In the Publications widget, expand the appropriate folder. Click the publication. The publication opens in the Content widget. Changing your password In the upper-right corner of the Web browser window, click Profile . In the Profile window, make your changes, and then click Close . Navigating around the publication You can navigate the publication in several ways: In the Contents widget, the TOC is displayed. When you click on a topic, it opens in the middle pane. In the Content widget, there are left and right arrow icons that enable you to move back and forward. In the Search widget, you can see results of a search on a phrase or term. Commenting on a topic There are two type of comments that you'll want to make: Comment and Change. Ignore Note. Click Enable Annotating , and navigate to the topic on which you want to comment. Click either Comment or Change . Select a block of text in the topic. A window is displayed. If you clicked Comment , it is blank; if you clicked Change , it is populated with the text that you selected. Type your comment (or edit the displayed text), and then click the Floppy disk icon. Viewing comments on a topic You can view the comments both in the Content widget and in the Annotations widget. If you are viewing a topic and have the Annotations widget open, all the comments present in the topic are displayed in the widget. You can view the comments in the Content widget. You can toggle how the comments are displayed -- whether all comments are displayed inline or whether they are just indicated by a small icon -- by clicking Show All Annotations or Hide Annotations . Show All Annotations view: Hide All Annotations view: Comment icon highlighted with red box If you have hidden the annotations, you can open a single one by clicking on the Comment icon. -- Best, Kris

Using DITAweb for the OASIS DITA TC's reviews Here are some tips about using DITAweb. Please note that the interface is built of window widgets that you can show or hide; you also can float them to where you want them. Getting started Go to ditaweb.com/oasis-dita . In the upper-right corner, click Sign In . Type your user name and password, and then click OK . Your username is your first initial followed by your last name (all lower case). If you need your password reset, contact me or Robert Anderson. In the Publications widget, expand the appropriate folder. Click the publication. The publication opens in the Content widget. Changing your password In the upper-right corner of the Web browser window, click Profile . In the Profile window, make your changes, and then click Close . Help; I can't see a window or window that that I need If you don't see a widget or have closed it and need it back, click Widget Manager . Navigating around the publication You can navigate the publication in several ways: In the Contents widget, the TOC is displayed. When you click on a topic, it opens in the middle pane. In the Search widget, you can see results of a search on a phrase or term. If topics do not open in the middle pane when you click on the TOC, please use the search functionality. Viewing all the comments that reviewers have made in a publication If a review has existing comments, I encourage reviewers to scan them before entering new comments. The method described below is the most efficient way to accomplish this: In the Annotation s pane, click Publication . In the Filter by status field, click All . Click Report . A browser window opens that displays all of the comments made in the review. If you are looking at a specific topic, note that replies to a comment are not immediately obvious. Look at the upper-right hand corner of a comment and see whether an icon is displayed: Commenting on a topic There are two type of comments that you'll want to make: Comment and Change. Ignore Note. Click Enable Annotating , and navigate to the topic on which you want to comment. Click either Comment or Change . Select a block of text in the topic. A window is displayed. If you clicked Comment , it is blank; if you clicked Change , it is populated with the text that you selected. Type your comment (or edit the displayed text), and then click the Floppy disk icon. Viewing comments on a topic You can view the comments both in the Content widget and in the Annotations widget. If you are viewing a topic and have the Annotations widget open, all the comments present in the topic are displayed in the widget. You can view the comments in the Content widget. You can toggle how the comments are displayed -- whether all comments are displayed inline or whether they are just indicated by a small icon -- by clicking Show All Annotations or Hide Annotations . Show All Annotations view: Hide All Annotations view: Comment icon highlighted with red box If you have hidden the annotations, you can open a single one by clicking on the Comment icon. -- Best, Kris