Uploaded image for project: 'OASIS Message Queuing Telemetry Transport (MQTT) TC'
  1. OASIS Message Queuing Telemetry Transport (MQTT) TC
  2. MQTT-496

Use hyperlink rather than cross reference

    XMLWordPrintable

    Details

    • Type: Bug
    • Status: Closed
    • Priority: Major
    • Resolution: Fixed
    • Affects Version/s: 5, CSD01
    • Fix Version/s: 5, wd16
    • Component/s: edits
    • Labels:
      None
    • Proposal:
      Hide

      Change all cross references to hypherlinks

      Show
      Change all cross references to hypherlinks

      Description

      The TAB is busy producing a handbook for OASIS spec editors with the goal of providing practical advice to help them get specs together efficiently. 

      However, we identified one tip that, because it is so black and white, we wanted to get out immediately. 

      When creating links in Word or Open Office, whether intra-document or inter-document, do not use the cross-reference feature. Use hyperlinks to bookmarks you have set instead. 

      The reason for this is that we've realized that while cross-references work fine in the tool, when we save your spec as PDF or HTML, the cross-reference links are not saved. We have encountered this in some documents lately and we haven't found a way to fix it.

      Bookmarks work even though they take more effort on your part. Mark any text that you want to act as a link target as a bookmark using your editing tool. (E.g. highlight the text and select Insert / Bookmark.) 

      Then, use Insert / Hyperlink, select the document and select the bookmark. 

      We have never encountered problems with links done this way even where the editors have constructed complex links to different directories, etc. 

      If anyone knows of a method for making cross-references work, please let us know. Meanwhile, to ensure that your links work in all cases, use Bookmarks and Hyperlinks. 

        Attachments

          Activity

            People

            • Assignee:
              ken.borgendale Ken Borgendale
              Reporter:
              ken.borgendale Ken Borgendale
            • Watchers:
              1 Start watching this issue

              Dates

              • Created:
                Updated:
                Resolved: