Uploaded image for project: 'docs'
  1. docs
  2. DOCS-18

Single page version of manuals (in addition to current site, not instead of it)

    XMLWordPrintable

Details

    • Bug
    • Status: Closed
    • Resolution: Won't Do
    • Beryllium
    • None
    • Toolchain
    • None
    • Operating System: All
      Platform: All

    • 5728

    Description

      Somehow clicking through Next> Next> Next> Next> on docs/manuals/getting-started-guide/target/docbkx/webhelp/bk-getting-started-guide/content/index.html (BTW see DOCS-16 about getting this live published) makes reading that more painful than just scrolling through long single pages such as e.g. https://www.opendaylight.org/installing-opendaylight or https://docs.google.com/document/d/12O86Nc4IbHvBC_ZGE_tHl0IWYd75Lk2HzfcV4YxhWTg/pub - those longs document are kind of a handy format, too.

      As Asciidoctor certainly can produce such single page HTML as well, how about also offering that, in addition to the current chunked chapter one? I noticed the PDF icon in the bar on top - perhaps next to it would be a suitable place for a link to a single page HTML of the entire manual? (The PDF itself is less idea to read on-screen I feel, and IMHO not a valid alternative to the additional HTML free flowing format proposed here.)

      Would any help to implement this be welcome?

      Attachments

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

        Activity

          People

            Unassigned Unassigned
            vorburger Michael Vorburger
            Votes:
            0 Vote for this issue
            Watchers:
            2 Start watching this issue

            Dates

              Created:
              Updated:
              Resolved: