Notes2

From Apache OpenOffice Wiki
Revision as of 18:34, 31 January 2008 by ChristophNoack (Talk | contribs)

Jump to: navigation, search
Hi! You just want to see the highlights?

Introduction

Team notes.png

Notes2 addresses the revision of the notes functionality in OpenOffice.org Writer to improve its usability and accessibility. Main goal is to resolve the main issues of the current implementation, which are reported by users. Furthermore, the notes implementation should at least provide the functionality of the competitors in the same class. In long term considerations, it is intended to consistently implement the notes functionality in the other OpenOffice.org modules. The main target audience is the Small-Business-User.

Notes2 is a project which has been started as one accepted project in Google's Summer of Code 2007 (GSOC).

The team working on the feature (in alphabetical order):

Name OOo Nickname Role
Mathias Bauer mba GSOC Mentor, Development
Uwe Fischer ufi Documentation
Christian Jansen cj Mentor, User Experience
Christoph Noack christophnoack User Experience
Maximilian Odendahl mod GSOC Student, Development
Éric Savary es QA


Please note that the information in this Wiki is work in progress and may change.

Requirements

Scope of the Work

  • Provide direct and easy editing of notes to get rid of the old notes editing window.
  • Establish good accessibility for disabled users by providing keyboard shortcuts or using appropriate colors.
  • Integrate the new functions in the existing functionality, e.g. the OpenOffice.org Navigator.
  • Respect the needs for advanced text editing, e.g. spell checking, rich-text formatting or sorting/filtering of notes.
  • Create both fresh and usable visual design of the notes.

Issues and Requests for Enhancements

The work will address the issues and request for enhancements: 767, 1981, 4964, 5487, 6193, 9776, 23465, 32232, 45788, 48150, 62625, 63759, 74157, 61644 and 80135.

You can use a Issue Tracker query to see all issues.

Requirements Derived from Use Cases

More detailed requirements have been collected and will be published here later.

Competitive Analysis

Competitor software is discussed on the separate page Competitive Analysis for Notes.

Definition of Terms

The following list contains some definitions used in the subsequent text (in alphabetical order):

Term Description Shown in Graphic Below
Author The user who edits or edited the Document. no
Document The Document is the file which contains the user's data. The type of the Document is dependent on the OpenOffice.org module used for editing, e.g. Writer text document, Calc spreadsheet document, Impress presentation document, Draw drawing document. no
Document Content The document content is dependent on the type of the Document. It includes e.g.
  • characters, strings, words, sentences, paragraphs
  • Sections (Writer)
  • Cells (Calc)
  • Slides (Impress)
  • Graphic Objects (Impress, Draw)
  • Input Fields (Base)
no
Document, Current The Current Document is the Document that the user uses at the moment. no
Note The Note refers to all elements and data which belong to the Notes Functionality (e.g. Note Anchor, Note Window, Note Property Data, Note Connector Line). Simplified, the Note contains all user visible elements. no
Note Anchor General name for the reference position of the Note Data which is located in the Document Content. For improved clearness, the Notes Data is not displayed inside the Document. Consequently, an Anchor is necessary to indicate the reference position. no
Note Anchor Area A special version of the Anchor which refers to a group of Document Content elements. The Anchor Area It is defined by a starting point and a end point according to the reading direction of the Document. yes
Note Anchor Point A special version of the Anchor which refers to a position inside the Document. The Anchor Point may be located between characters and therefore treated as character. yes
Note Connector Line The notes connector line is the graphical representation of the relationship between Notes Anchor and Notes Window. yes
Note Data General name for the data which is stored for the Notes, e.g. Note User Data or Note Property Data. no
Note Functionality The generic term which refers to the revised implementation of Notes handling in OpenOffice.org no
Note Property Data The Note Property Data refers to all the data of a note which does not belong to the Note user data. It may contain:
  • Status of the Note Window (e.g. shown/hidden, rolled in/out, position)
  • Rating of the User (e.g. priority, task completion, filtered/unfiltered)
  • History (author who created the note, author of the last change, date of creation, date of last change)
  • Relationship to other Notes (e.g. reply status)
yes
Note Side Pane The screen area next to the Document which is reserved for displaying the Notes Windows. yes
Note User Data The user defined content of the Note, e.g. text, graphics. yes
Note Window The screen area which contain the Note Data. This window is usually used to view or edit the Note User Data. yes

The following picture shows some examples for the terms defined above:

Definition of Terms

Status and Proposals

The following table lists the topics currently worked on and refers to the more detailed design proposals.

Topic Description Status Detailed Design
General Interaction Interaction with the Notes Anchors and Note Windows inside the Writer document window. Proposal in discussion. Implementation started. Working with Notes
Design of the Notes Side Pane The notes side pane will extend the document pages to contain the notes windows. Implementation started. Note Side Pane
Design of the Notes Windows The notes window will contain the notes text and further information like the author's name and time and date information. Implementation started. If necessary, the window will be extended by a scrollbar for the text. Note Window

Note Property Data

Design of the Notes Anchor The Note Anchor is the markup inside the document text to show that there is some notes information present. Proposal in discussion. Note Anchor
Design of the Notes Connector Line The Notes Connector Line is the visual connection between the notes anchor and the corresponding notes window. Proposal in discussion. Note Connector Line
Colors of the Notes Windows Colors for the Notes Windows. These colors are shared with the Writer change tracking feature. Implementation for Notes started. Implementation for the Writer change tracking feature finished. Main Colors
Distribution of the Notes Windows in the Side Pane Placement of the Notes Windows inside the Notes Side Pane (e.g. size, position). Proposal in discussion. Implementation started. Note Window Distribution
Menus and Keybindings Covers menu changes and keybindings (e.g. shortcut for insert notes) for the interaction with the Notes functionality. Proposal in discussion. Implementation started. n/a
Rich-Text-Formatting Use of attributes to markup the notes text (e.g. bold text). Implementation started. n/a
Focus Visualization The Note Windows of a currently viewed or edited Note is highlighted. Proposals in discussion. Preliminary implementation started. Visualization of Focus

Roadmap

Development Releases

The functionality will be implemented step-by-step.

A first release of the revised notes functionality is planned for OpenOffice.org Beta 3.0 around April 2008, the corresponding Notes2 Specification is under development. A more detailed description (or let's say developer friendly version including CWS status and links) on what is planned can be found at Notes2_CWS.

Official Releases

Functionality expected in the first release (OpenOffice.org 3.0):

  • Viewing and editing notes next to the document page
  • Accessibility support
  • The functionality which is already available in current version of OpenOffice.org
  • Improved integration with the Writer change tracking feature (e.g. use the same colors for the authors of the document)
  • Time information for the notes (besides the already available date information)
  • Rich-text editing (e.g. bold text, numerations)
  • Online help
  • Support for the OpenOffice.org Testtool

Functionality expected in later releases (OpenOffice.org 3.x):

  • Improved printing
  • Improved print preview
  • Search for text inside of notes
  • Spellchecker inside of notes (underlining with right click spell checking already available)
  • Improved integration with the OpenOffice.org Navigator
  • attaching comments to a selection of text because then ODF 1.2 will support this feature (Notes Anchor Area)

Other Ideas

Other ideas are discussed on the separate page Other Ideas for Notes.

Mockups and Screenshots

This section contains mockups and screenshots:

  • Mockups are working models used for demonstration purposes. There is no real functionality at all, because the following pictures have been composed with graphic programs just to get a first impression how it will look like.
  • Screenshots show the behavior of the real development in OpenOffice.org Writer. Those pictures are updated more or less regularly.
Mockup for viewing the notes
Mockup shows the mode for "viewing" the notes:
  • different kinds of notes anchors in the document text:
    • anchor point (represents a character)
    • anchor selection
  • a side pane next to the document page for displaying and arranging the notes windows (including some information in the ruler above)
  • display of author and date inside the notes windows
  • different colors for different authors
  • (idea) a placeholder to just start typing the notes text (anchor would be placed at current document text position)
Mockup for editing the notes
Mockup shows the mode for "editing" the notes:
  • visualization of currently edited note
    • continuous anchor connector line
    • highlighted notes anchor selection (slightly darker border lines)
    • shadow for the notes window (whereas the shadow for the document page is removed)
  • spell checking inside the notes windows
Mockup for a hidden notes pane
Mockup shows the mode for a "hidden notes" pane (just an early idea):
  • notes pane is completely hidden (including notes windows)
  • the ruler above provides some information on the notes
    • information that there are (at least) some notes present in the document
    • the notes pane can be shown by the control element in the ruler bar
Alpha version Writer
Personal tools