Notes2

From Apache OpenOffice Wiki
Revision as of 14:12, 15 August 2007 by Mba (Talk | contribs)

Jump to: navigation, search

Introduction

Notes2 is a new project started as one accepted project in Google's Summer of Code 2007 (GSOC). It will be also worked on after the GSOC is over.

Notes 2 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.

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

The team working on the feature (in alphabetical order, OOo names in parenthesis):


Name OOo nick role
Mathias Bauer mba GSOC Mentor, Development


Uwe Fischer ufi


Documentation


Christoph Noack christophnoack


User Experience


Maximilian Odendahl mode


GSOC Student, Development


Éric Savary es


QA



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.

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

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.


Competitive Analysis

During the development we did some investigation on software applications of competitors.

MS Word 2003
Microsoft Word 2003 (word processor)

(Add some descriptive text here.)

[[Image:]] Apple Pages 2 (word processor)

(Add some descriptive text here.)

[[Image:]] Softmaker Textmaker 2006 (word processor)

(Add some descriptive text here.)

Other Ideas

(Do we have any other ideas we like to share? Navigator, Send via E-Mail, ...)


Roadmap

The functionality will be implemented step-by-step. A first release of the revised notes functionality is planneded for OpenOffice.org 2.4 around February 2008. A first release of a specification draft can be expected at the end of August 2007.

Functionality Expected in the first release

The basic functionality which is present in the current version of OpenOffice.org will be available in OpenOffice.org 2.4. It is planned to implement:

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

Functionality Expected in Later releases

  • Improved printing
  • Search for text inside of notes
  • Configurability of the visual representatons (e.g. colors)
  • Improved integration with the Writer change tracking feature (e.g. use the same colors for the authors of the document)
  • Improved integration with the OpenOffice.org Navigator

Status

The following table lists the topics currently worked on.


Topic Description Status More Information...
General Interaction Interaction with the notes anchors and windows inside the Writer document window. This includes design decisions to make the notes functionality be as robust as possible. Proposal in discussion. Implemenation started.
Design of the Notes Sidepane The notes sidebar will extend the document pages to contain the notes windows. Early proposal in discussion. Implemenation started.
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. Early proposal in discussion. Implemenation started.
Design of the Notes Anchor The notes anchor is the markup inside the document text to show that there is some notes information present. Early proposal in discussion. (Hyperlink to proposal? PDF?)
Design of the Connector Line. The notes connector line is the visual connection between the notes anchor and the corresponding notes window. Not started yet.
Colors of the Notes Windows Colors for the notes windows. In future version this colors will be shared with the Writer change tracking feature. Proposal in discussion. (Hyperlink to proposal? New Wiki Page?)
Distribution of the Notes Windows Placement of the notes windows inside the notes sidepane (e.g. size, position). Proposal in discussion. Implemenation started.
Keybindings Keybindings for the interaction with the notes (e.g. insert notes). Proposal in discussion. Implemenation started.
Rich-Text-Formatting Use of attributes to markup the notes text (e.g. bold text). Election of requirements.


Implementation considerations

Choice of implementation

The implementation has to be able to handle at least the following items:

  • scrollable
  • able to handle richtext to include text with attributes
  • spell checking
  • different position, sizes and background colors
  • able to be drawable inside the right margin


After discussion with several people, there seem to be two different possibilities:

implementation advantages disadvantages
OverlayTextObject using the drawing layer possible use of GUI gimmicks such as transparency, animations etc. large implementation effort

tight interaction with drawing layer neccessary no scrollbars


own window code nicely seperable from other OO code

no extra implementation effort for scrollbars


maybe alien look in rare cases

Both implementation will use the EditEngine as well as an OverlayObject for a connection line from anchor point to the note itself

Update: Decision was made to go with a seperate window first

Collection of topics to be considered

Several questions related to the appearance and usability have to be decided:

  • main color of notes
    • Suggestion: natural color of physical postit notes)
  • when to show vertical scrollbars if all notes need it due to a full page: if we show them,it could be confusing to the user and could look alien, if we don't, user might not be aware of the full length and miss text
  • what about meta information such as date and author
    • permantly inside the note
    • in the tooltip
    • inside the navigator
    • titlebar
  • different colors or intensity when editing a certain note
  • appearance of connection line from anchor point to note
    • could be a dotted line turning into a full line while editing or always a full line
    • flashing object


Further Thoughts

There are several items which are nice to have, but will eventually not make it into the first release:

  • different colored boxes for different authors, adjustable by user
  • attaching comments not only to a text position, but also a selection of text. As the ODF format for notes does not allow this currently, there are two possibilities:
    • use ODF metadata, if version 1.2 is approved
    • in collaboration with other ODF implementations, change the format of notes inside the ODF format
  • printing of notes
  • nicer appearance, e.g. round corners for notes


Screenshots of other notes implementations

File:Note oo.JPG
OpenOffice with Patch

note in right margin, yellow postit color



TextMaker 2006

note in right margin with extending of white paper background, red color



MS Word 2003

note in right margin with extending of white paper background, red color



Apple Pages
Personal tools