wiki:UNPLANNED_PALETTES_REFACTORING_R0

Version 11 (modified by todor, 16 years ago) (diff)

--

Error: Macro BackLinksMenu(None) failed
compressed data is corrupt

Error: Macro TicketQuery(summary=UNPLANNED_PALETTES_REFACTORING_R0, format=table, col=summary|owner|status|type|component|priority|effort|importance, rows=description|analysis_owners|analysis_reviewers|analysis_score|design_owners|design_reviewers|design_score|implementation_owners|implementation_reviewers|implementation_score|test_owners|test_reviewers|test_score|) failed
current transaction is aborted, commands ignored until end of transaction block

Analysis

(Give as much as possible of the needed information for designing and implementing the task in the following sections.)

Overview

This task is oriented towards fixing, tuning and refining the palettes that we are using now. The goal is to refactor the following palettes from their respective tabs:

  • Left flap
    • Books tab
      • Opened books palette
      • Embedded books palette
      • Page preview palette
    • Servers tab
      • Connections palette
      • Server resources palette
  • Right flap
    • Resources tab
      • Resources palette
      • Detail view palette
    • Changes tab
      • Changes palette
    • Book extras tab
      • All annotations palette
      • Book extras palette
      • Stickies palette

Task requirements

  • Make the palettes more usable:
    • Open books palette
      • It should display list of the open books, the user should be able to change the book on focus by choosing book title from there (this is working now).
      • When a book is selected (by clicking on the book window or selecting it from window menu, or clicking on its title in the tab bar) its name should be highlighted in the Opened books palette.
      • When a book is dragged from books palette to the current book it should be embedded (this is probably part of the drag and drop tasks).
    • Embedded books palette:
      • It should display list of all embedded books in the current book (it should be empty in case that there is no book on focus).
      • There should be visual indicator whether the embedded book is linked book or it is copied in the resources of the user's book. When a linked embedded book is double clicked it pop up window that asks the user whether he/she wants to download and load the book should appear.
      • When the user clicks on the name of copied embedded book, the frame where the book is embedded should be displayed and on focus.
    • Page preview palette:
      • Page preview palette should display thumbnails of the book pages (for now there are lots of bugs there #1995).
      • There should be a border of the page thumbnail. This is because now when the page background is white the user don't see how big is his page.
      • The thumbnails should be scalable. When the palette is resized the page thumbnails should be resized too.
      • There should be a visual marker for the current page (maybe a shade or outline).
      • When the user clicks on page thumbnail it must be displayed (this is working now).
      • The user should have the ability to rearrange pages by dragging pages in the page preview palette up and down (this is probably part of the drag and drop tasks).
      • The Add Page Before and Add Page After Button should be with equal sizes (probably it is good idea to change their name to something shorter).
    • Connections palette:
      • The buttons in the server palette must be equal, now add server, remove server toggle server are with different widths.
    • Server resources palette is part of UNPLANNED_APP_CLIENT_RESOURCES_R0.
    • Resources palette:
      • There must be different filters in the palette in order to show only one type of resources.
        • Now there are three buttons PDF, Script and Image in the default skin that don't look as buttons.
      • (optional) A search bar for finding specific resources by name will be useful when editing bigger books with more resources.
    • Detail view palette:
      • It must contain preview of the selected resource
      • It must contain meta information for the resource
      • The Copy button is obsolete
    • All annotations palette:
      • Select as current button is obsolete this action can be done only by clicking on the desired extra.
      • The rest of the buttons should be with equal size (you may change the names of some).
    • Book extras palette probably is obsolete so until we figure out what it shall contain we probably have to drop it.
    • Stickies palette:
      • It should lists all created stickies for the current annotation set.
      • The user should be able to click on a sticky ant the application should show the page on which is it.
    • Changes palette:
      • There must be a field in which the user enters the number of the changes that are shown in the palette and confirmation button.

Task result

The resource of this task must be a source code. Resulting in improvements of the palettes functionality.

Implementation idea

The task requirements give some implementation ideas however,

  • It is good to have a discussion with the people doing Sophie look and feel.
  • It is recommended to think of shorter and more user friendly names for some of the palettes and buttons.

How to demo

Show the new palettes and their improved looks and capabilities (e.g. switch books using open books palette, rearrange some pages using page preview palette).

Design

(Describe your design here.)

Implementation

(Describe and link the implementation results here (from the wiki or the repository).)

Testing

(Place the testing results here.)

Comments

(Write comments for this or later revisions here.)