OASIS Darwin Information Typing Architecture (DITA) TC

 View Only

Base spec: Review Dave Alvin, indexes and index elements take two

  • 1.  Base spec: Review Dave Alvin, indexes and index elements take two

    Posted 25 days ago
    Please review the PDF, and then enter your comments in Content Fusion.  Please note that we have very, very specific requirements for how we need reviewers to use Content Fusion:
    • Make all new comments as draft comments in the source. Do not use the native Content Fusion comment function. This is necessary so that we can retain and archive a clear record of the discussion that took place in the review, as well as resolution of the comments.
    • To respond to a draft comment, edit the existing draft comment. We suggest specific markup to use.
    See the information about using Content Fusion at the bottom of this e-mail.
    Link to review PDF
    Email contains both the review PDF (fusion-review-davealvin.pdf) and the updated PDF showing comments from the first indexing review:
    Link to Content Fusion review
    Link to latest version of the DITA 2.0 spec
    Information about using Content Fusion
    Inserting a draft comment
    1.       In the Editor pane, place your cursor where you want to insert the draft comment.
    2.       Right-click Insert > Insert Element.
    3.       Select Draft Comment.
    4.       Add content to the draft comment, using standard DITA markup.
    Ensure that the @author and @time attributes clearly indicate your name and the date that you added the draft comment.
     
    Editing a draft comment to respond to a comment
    1.       In the Editor pane, place your cursor at the end of the content within the existing draft comment.
    2.       Insert a <div> element:
    a.       Right-click Insert >Insert Element.
    b.       Select Division.
    c.       Add a paragraph with your name and the date, followed by your comment
    Thanks,
    Robert Anderson