Uploaded image for project: 'Qt'
  1. Qt
  2. QTBUG-32109

"Getting Started" guide refers to code line numbers that don't exist

    XMLWordPrintable

Details

    • Bug
    • Resolution: Done
    • P2: Important
    • None
    • 5.1.0 RC1
    • Documentation
    • None
    • 9e399a7d41da4ff69cd8ec0e335d5777a5274969

    Description

      Issue
      In "Getting Started Programming with Qt Widgets" page (http://doc-snapshot.qt-project.org/qt5-release/qtdoc/gettingstartedqt.html), the body text refers to line numbers of code snippets: "Line 4 defines... Line 6 creates... Line 8 shows...". However, the line numbers are not displayed.

      This issue is important because this page is targeted at absolute beginners, who need to be guided through the logic. Missing references would likely slow them down and frustrate them.

      History
      Code snippets used to come with line numbers (http://doc.qt.digia.com/4.7/gettingstartedqt.html). This is no longer the case. EDIT: Actually, the line numbers were hard-coded into the Qt 4.8 documentation. Probably not something we want to promote.

      Suggestion
      I can think of two options:

      1. Rewrite the tutorial to not require line numbers
      2. Bring back line numbers in code snippets

      Other
      I did a regex search, "(L|l)ine [0-9]+", on all the repos that are part of Qt 5.1 – This is the only page that refers to line numbers.

      Attachments

        No reviews matched the request. Check your Options in the drop-down menu of this sections header.

        Activity

          People

            leenam Leena Miettinen
            jksh Sze Howe Koh
            Votes:
            0 Vote for this issue
            Watchers:
            4 Start watching this issue

            Dates

              Created:
              Updated:
              Resolved:

              Gerrit Reviews

                There are no open Gerrit changes