[[BackLinksMenu]]

[[TicketQuery(summary=GROUP_HELP_R1, 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|)]]

= Analysis =
== Overview ==
Add tooltips for most of the existing controls and elements.
== Task requirements ==
 * Create a convention for the tooltips (How should a tooltip look, punctioation marks, etc.)
 * Create a list of ALL needed tooltips for the application
  * Existing
  * Nonexisting
  * Layout elements
   * Flaps
    * Flap controls
   * Tabs
   * Palettes
   * Tabs in opened books tabbar
   * App window buttons
   * Book window controls
   * Menu items
   * Halos
   * Hud controls
  * Book elements
   * Frames
   * Frame borders
   * Page work area
 * Make the tooltips easily accesible and editable (in a file for example)
  * See if they are in skin
== Task result ==
Convention, list of tooltips, code.

== Implementation idea ==
http://wayfarerweb.com/wtooltip.php
||'''Element'''||'''Existing tooltip'''||'''New tooltip'''||
||Open Menu Item||Open existing book.||Open existing book||
== Related ==
[wiki:GROUP_APP_HELP_R0]
== How to demo ==
Show the convention and the new tooltips.

= Design =
== Convention ==
Every tooltip is a sentence that doesn't have a period at the end of a sentence. If there is a shortcut connected with this action, it should be written in parentheses.
== Tooltips ==
=== Menu bars and menus ===
||	File	||	File Menu	||	File Menu (Alt-F)	|| 
||	New Book	||	Create a new book.	||	Create a new book	||
||	Open Book...	||	Open an existing book.	||	Open an existing book	||
||	Close	||	? ||	Close the current book	||
||	Save	||	Save the current book to a file.	||	Save the changes made to the current book	||
||	Save As...	||	Save the current book to another file.	||	Save the current book to a file	||
||	Save As	Template	||	Save the current book as a template.	||	Save the current book as a template	||
||	Export Book As		||	?	||	Save the book As a non-Sophie file format	||
||	PDF...	||	?	||	Save the book As an Adobe Portable Document Format losing some of the content	||
||	HTML...	||	?	||	Save the book As a Web Page losing some of the content	||
||	Print...	||	? ||	Print a page or the whole book to paper	||
||	Book Properties...	||	? ||	View or edit current book's title and dimensions	||
||	Quit	||	?	||	Exit Sophie 2	||
||||||||
||	Edit	||	Edit Menu ||	Edit Menu (Alt-E)	||
||	Undo	||	? ||	Discard the last change	||
||	Redo	||	? ||	Repeat the last discarded change	||
||	Cut	||	?	||	Move the selected element to another location by pasting	||
||	Copy	||	?	||	Copy the selected element to another location by pasting	||
||	Paste	||	?	||	Put the last copied/cut element to selected location	||
||	Delete	||	?	||	Remove the selected element from it's current location	||
||||||||
||	Insert	||	Insert Menu ||	Insert Menu (Alt-E) ||
||	Text	||	?	||	Add an empty text frame to the current page	||
||	Image...	||	?	||	Add an image file to the current page	||
||	Audio...	||	?	||	Add an audio file to the current page	||
||	Audio Record...	||	?	||	Record an audio file and add it to the current page	||
||	Video...	||	?	||	Add a video file to the current page	||
||	Book...	||	?	||	Add a whole book to the current page	||
||	PDF...	||	?	||	Add a PDF document to the current page	||
||	HTML...	||	?	||	Add a Web page to the current page	||
||	Plain text...	||	?	||	Add a text file to the current page	||
||	Browser	||	?	||	Add an interactive web page browser to the current page	||
||	Script	||	?	||	Create an empty script file that can control Sophie	||
||	Script file...	||	?	||	Insert a script that can control Sophie	||
||||||||
||	View	||	View Menu	||	View Menu (Alt-V)	||
||	Normal mode	||	?	||	Switch the view back to a normal window	||
||	Full screen mode	||	?	||	View the application on the whole screen for more convinient work	||
||||||||
||	Skins	||	Skins Menu	||	Skins Menu (Alt-S)	||
||||||||
||	Window	||	Window Menu	||	Window Menu (Alt-W)	||
||	Cascade	||	?	||	Stack book windows so that each window title bar is visible	||
||	Tile	||	?	||	Arrange book windows so they are shown side by side	||
||	Book Window Item	||	?	||	Book Title	||
||||||||
||	Help	||	Help Menu	||	Help Menu (Alt-H)	||
||	Help Contents	||	?	||	Display main help index	||
||	Send an Error Report	||	?	||	Report problems related to application use	||
||	About	||	?	||	Show version and licence information	||
=== Opened books tabbar ===
||	Show Desktop	||	?	||	Book desktop - drag frames, resources, etc to the book desktop to make them easily reusable	||
||	Book Tab Item	||	?	||	''Full book name''	||
=== Flaps ===
||	Left	||	?	||	Browse, download, preview books	||
||	Right	||	?	||	Edit books, templates	||
||	Bottom	||	?	||	View and edit timelines	||
=== Tabs ===
||	Books	||	?	||	Lists opened and embedded books	||
||	Book item in Opened books palette	||	?	||	''Book name'' - double click to switch to this book	||
||	Book item in Embedded books palette	||	?	||	''Book name'' - This book is embedded, double click to open it in another window	||
||||||||
||	Pages	||	?	||	Shows thumbnails of pages of the current book and gives opportunity to navigate between pages	||
||	Page item	||	?	||	Click to switch to that page, drag to reorder; drag a page template to the palette to create a new page	||
||||||||
||	Tools	||	?	||	Provides alternative navigation ways such as search	||
||	Search Field	||	?	||	Enter text to search for	||
||||||||
||	Config	||	?	||	Application setup and configuration	||
||	Plugin item	||	?	||	''Name of the plugin''	||
||	Enable button	||	?	||	Enable the selected plugin to use functionalities that it provides	||
||	Disable button	||	?	||	Disable the selected plugin, plugins that depend on this one will also be disabled	||
||||||||
||	Servers	||	?	||	List of available servers and connectivity options	||
||	Server item	||	?	||	''Server Name''	||
||	Toggle selected button	||	?	||	Connect or disconnect from the currently selected server	||
||	Refresh button	||	?	||	Get recent server list	||
||||||||
||	Resources	||	?	||	Used and not used contents of the current book	||
||	Copy	||	?	||	Duplicate the selected resource	||
||	Delete	||	?	||	Remove the selected resource	||
||	Changes	||	?	||	History of the actions performed to the current book	||
||	Library	||	?	||	Lists existing templates for creating frames, pages and books with properties given in advance	||
||	Frame template item	||	?	||	Double click to apply to a selected frame or drag to a page to create a new frame	||
||	Page template item	||	?	||	Double click to apply to the current page or drag the page preview palette to create a new page	||
||	Book template item	||	?	||	Drag to a page to create an embedded book from the template, double click to create a new book from the template	||
||	Book Extras	||	?	||	Shows content that is not part of the book such as stickies, highlights and other external content related to the book	||
||	Add Sticky	||	?	||	Add a little yellow sticky note to the page (this note is not part of the book)
||	Styles	||	?	||		||
||	Timelines	||	?	||	Shows interactivity controls	||
=== Book window ===
||	Zoom panel	||	?	||	Zoom in or out to see less/more of the current page elements (Ctrl-+/Ctrl--/Ctrl+*)	||
||	Page selector go to prev page	||	?	||	Go to previous page of the book	(PgUp)||
||	Page selector go to next page	||	?	||	Go to next page of the book	(PgDown)||
||	Page selector text field	||	?	||	Current page, type in a number to go to that page	||
||	Search text field	||	?	||	Enter text to search	||
||	Search prev	||	?	||	Go to previous search result	||
||	Search next	||	?	||	Go to next search result	||
||	Outline frames	||	?	||	Show frame bounds (border, margins and padding)	||
||	Open preview	||	?	||	View the book in a separate window just like it will look to the readers	||
=== Book content ===
||	Resize cursor	||	?	||	Drag to resize the frame	||
||	Text/Audio/Video/Book/PDF/Browser Frame	||	?	||	Text/Audio/Video/Book/PDF/Browser frame, you may drag another resource here to replace this frame's content	||
||	Page	||	?	||	Drag resources to the page to create frames with this resources as content	||
=== Halos ===
||	FramePropertiesHalo	||	?	||	Frame Properties - Edit size, bounds, position and orientation	||
||	FrameAppearanceHalo	||	?	||	Frame Appearence - Edit frame border and background style	||
||	Increase z-order halo	||	?	||	Increase Z order - Get the frame nearer (in front of neighbour frames)	||
||	Decrease z-order halo	||	?	||	Decrease Z order - Get the frame further (behind neighbour frames)	||
||	LinkHalo	||	?	||	Link management - Add or remove links to other objects	||
||	DeleteHalo	||	?	||	Delete frame - Remove this frame from the page and the resources palette	||
||||||||
||	GroupHalo	||	?	||	Group - Create a group of the selected objects to manipulate them as one	||
||	UngroupHalo	||	?	||	Ungroup - Break the existing group to release the dependency between grouped objects	||
||	AlignHalo	||	?	||	Align - Align selected objects on the page	||
||	EnterGroupHalo	||	?	||	Enter group - Start editing the objects inside the group as they were not grouped	||
||	ExitGroupHalo 	||	?	||	Exit group - Stop editing the objects inside the group and return to parent object (group or page)	||
||	CharacterHalo	||	?	||	Character - Edit font style	||
||	PararaphHalos	||	?	||	Paragraph - Edit text aligment, spacing, etc.	||
||	Content control halo (for video, audion, pdf, etc) 	||	?	||	Content - Edit preview options such as frame controllers	||
||||||||
||	AnchorHalo	||	?	||	Anchor - Click to show text anchoring options, drag to anchor	||
||	RotateHalo	||	?	||	Rotate - Click to show orientation options, drag to rotate	||
||	ChainingHalo	||	?	||	Chaining - Click to show chaining options, drag to another frame to choose where to extend current text	||
= Implementation =
^(Describe and link the implementation results here (from the wiki or the repository).)^

= Testing =
^(Place the testing results here.)^

= Comments =
I've added my suggested changes [wiki:SandBox/danvisel/GROUP_HELP_R1 here]. --danvisel