Difference between revisions of "Notes2"

From Apache OpenOffice Wiki
Jump to: navigation, search
(Implementation)
Line 193: Line 193:
  
 
=Implementation considerations=
 
=Implementation considerations=
 +
 +
==Choice of implementation==
  
 
The implementation has to be able to handle at least the following items:
 
The implementation has to be able to handle at least the following items:
Line 247: Line 249:
 
Update: Decision was made to go with a seperate window first
 
Update: Decision was made to go with a seperate window first
  
=Usability=
+
==Collection of topics to be considered==
  
 
Several questions related to the appearance and usability have to be decided:
 
Several questions related to the appearance and usability have to be decided:
Line 269: Line 271:
  
  
 
+
==Further Thoughts==
=QA entries related to notes in writer=
+
Work will address issues:
+
 
+
[http://www.openoffice.org/issues/show_bug.cgi?id=767 767], [http://www.openoffice.org/issues/show_bug.cgi?id=1981 1981], [http://www.openoffice.org/issues/show_bug.cgi?id=4964 4964], [http://www.openoffice.org/issues/show_bug.cgi?id=5487 5487], [http://www.openoffice.org/issues/show_bug.cgi?id=6193 6193], [http://www.openoffice.org/issues/show_bug.cgi?id=9776 9776], [http://www.openoffice.org/issues/show_bug.cgi?id=23465 23465], [http://www.openoffice.org/issues/show_bug.cgi?id=32232 32232], [http://www.openoffice.org/issues/show_bug.cgi?id=45788 45788], [http://www.openoffice.org/issues/show_bug.cgi?id=48150 48150], [http://www.openoffice.org/issues/show_bug.cgi?id=62625 62625], [http://www.openoffice.org/issues/show_bug.cgi?id=63759 63759], [http://www.openoffice.org/issues/show_bug.cgi?id=74157 74157], [http://www.openoffice.org/issues/show_bug.cgi?id=61644 61644] and
+
[http://www.openoffice.org/issues/show_bug.cgi?id=80135 80135].
+
 
+
See this [http://www.openoffice.org/issues/buglist.cgi?Submit+query=Submit+query&issue_type=DEFECT&issue_type=ENHANCEMENT&issue_type=FEATURE&issue_type=PATCH&issue_status=UNCONFIRMED&issue_status=NEW&issue_status=STARTED&issue_status=REOPENED&issue_status=RESOLVED&email1=&emailtype1=exact&emailassigned_to1=1&email2=&emailtype2=exact&emailreporter2=1&issueidtype=include&issue_id=767%2C+1981%2C+4964%2C+5487%2C+6193%2C+9776%2C+23465%2C+32232%2C+45788%2C+48150%2C+62625%2C+63759%2C+74157%2C+61644%2C+80135&changedin=&votes=&chfieldfrom=&chfieldto=&chfieldvalue=&short_desc=&short_desc_type=allwords&long_desc=&long_desc_type=allwords&issue_file_loc=&issue_file_loc_type=fulltext&status_whiteboard=&status_whiteboard_type=fulltext&keywords=&keywords_type=anytokens&field0-0-0=noop&type0-0-0=noop&value0-0-0=&cmdtype=doit&namedcmd=accessibility&newqueryname=&order=Reuse+same+sort+as+last+time query] for an overview.
+
 
+
=Release Dates=
+
Expected release of specification draft:      end of July 2007
+
 
+
Expected release of the new implementation:  OpenOffice.org 2.4 (around February 2008)
+
 
+
 
+
 
+
=Further Thoughts=
+
  
 
There are several items which are nice to have, but will eventually not make it into the first release:
 
There are several items which are nice to have, but will eventually not make it into the first release:

Revision as of 14:05, 15 August 2007

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.


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