Uploaded image for project: 'Lustre Documentation'
  1. Lustre Documentation
  2. LUDOC-104

version specific features should be identified programmatically.

Details

    • Improvement
    • Resolution: Fixed
    • Minor
    • None
    • None
    • None
    • 5607

    Description

      The Lustre Manual is currently rendered through the vanilla style transforms for Docbook 5. This produces documents that are generic in design.

      More powerful document design tools are only available using custom styling.

      The current tool chain should be modified to include custom transforms and style sheets that enable access to advanced design features.

      Attachments

        Activity

          [LUDOC-104] version specific features should be identified programmatically.

          The revision section of the manual needs updating to reflect on the continuous release and explain the use of version specific style elements.

          http://review.whamcloud.com/#/c/6947

          rhenwood Richard Henwood (Inactive) added a comment - The revision section of the manual needs updating to reflect on the continuous release and explain the use of version specific style elements. http://review.whamcloud.com/#/c/6947

          another patch closes up this issue for at least another release:

          http://review.whamcloud.com/#change,5753

          rhenwood Richard Henwood (Inactive) added a comment - another patch closes up this issue for at least another release: http://review.whamcloud.com/#change,5753

          Only l23 (lustre 2.3 and beyond) and l24 (lustre 2.4 an beyond) are currently configured. l21, l22, l25 should also be added.

          rhenwood Richard Henwood (Inactive) added a comment - Only l23 (lustre 2.3 and beyond) and l24 (lustre 2.4 an beyond) are currently configured. l21, l22, l25 should also be added.

          Since patch set 13 on:
          http://review.whamcloud.com/#change,4611

          You can see the lustre version specific conditional annotations in the html, xhtml, pdf and epub builds.

          rhenwood Richard Henwood (Inactive) added a comment - Since patch set 13 on: http://review.whamcloud.com/#change,4611 You can see the lustre version specific conditional annotations in the html, xhtml, pdf and epub builds.

          Not anything to see yet, I haven't hooked the custom transform into the make file.

          You need to checkout the change and run the command shown locally. Provided you're on a fedora 17 machine, it should work.

          rhenwood Richard Henwood (Inactive) added a comment - Not anything to see yet, I haven't hooked the custom transform into the make file. You need to checkout the change and run the command shown locally. Provided you're on a fedora 17 machine, it should work.
          rhenwood Richard Henwood (Inactive) added a comment - Draft for review. http://review.whamcloud.com/4611

          People

            rhenwood Richard Henwood (Inactive)
            rhenwood Richard Henwood (Inactive)
            Votes:
            0 Vote for this issue
            Watchers:
            1 Start watching this issue

            Dates

              Created:
              Updated:
              Resolved: