Uploaded image for project: 'Sakai'
  1. Sakai
  2. SAK-41012

Site Info > Manage Tools: Improve the layout of this page and standardize the tool descriptions

    XMLWordPrintable

    Details

    • 19 status:
      Resolved
    • Test Plan:
      Hide

      Ensure all of the original functionality of the Manage Tools page still works properly and as it did in previous versions (compare with an earlier release of Sakai), including:

      • instance tools (e.g. Lessons, Web Content, etc)
      • LTI tools
      • configured tools (e.g. News, etc)

      Ensure changes to tools made using Tool Order appears properly in the Manage Tools page (again, compare to previous Sakai versions).

      Ensure the page is responsive and works at various screen sizes.

      Ensure the tool descriptions are consistent (e.g. phrasing and format), clear (e.g. do they properly convey what the tool does or is used for? is it understood why you would use one tool over a similar tool?), and free from spelling and grammatical errors.

      Ensure all links, buttons, checkmarks, labels, and focusable elements work and respond properly.

      Show
      Ensure all of the original functionality of the Manage Tools page still works properly and as it did in previous versions (compare with an earlier release of Sakai), including: instance tools (e.g. Lessons, Web Content, etc) LTI tools configured tools (e.g. News, etc) Ensure changes to tools made using Tool Order appears properly in the Manage Tools page (again, compare to previous Sakai versions). Ensure the page is responsive and works at various screen sizes. Ensure the tool descriptions are consistent (e.g. phrasing and format), clear (e.g. do they properly convey what the tool does or is used for? is it understood why you would use one tool over a similar tool?), and free from spelling and grammatical errors. Ensure all links, buttons, checkmarks, labels, and focusable elements work and respond properly.

      Description

      The Manage Tools page needs some updating to clean up spacing and grouping to make it easier to read and use:

      • Use standard spacing and alignment to clean up the existing page, such as tool descriptions' grouping with their tool names, icons with the tool names, and checkboxes with their labels.
      • Make better use of the page real estate by removing awkward spacing, while also fixing crowding of other elements.

      Before:

      The tool descriptions also need to be standardized so they more-clearly describe what the tool will do for both maintain and access roles (since this description also appears in the left tool menu of Sakai when you hover over the tool for all users). Standardize parts of the descriptions, such as:

      • consistent overall phrasing, tone, and sentence structure
      • removal of developer-specific wording in favour of end-user-friendly descriptions
      • better describe the tools function for both maintain- and access-type roles

        Gliffy Diagrams

          Attachments

            Issue Links

            is related to

            Task - A task that needs to be done. SAK-33826 Update the tool description for GBNG

            • Minor - Minor loss of function, problem where easy workaround is present, or functionality which would be nice to have.
            • Verified

              Activity

                People

                • Assignee:
                  sfoster9 Shawn Foster
                  Reporter:
                  sfoster9 Shawn Foster
                • Votes:
                  0 Vote for this issue
                  Watchers:
                  2 Start watching this issue

                  Dates

                  • Created:
                    Updated:
                    Resolved:

                    Git Source Code