GSoC 2012 Improve Usability Chelen: Difference between revisions

From Scribus Wiki
Jump to navigation Jump to search
No edit summary
m (Protected "GSoC 2012 Improve Usability Chelen" ([edit=sysop] (indefinite) [move=sysop] (indefinite)))
 
(30 intermediate revisions by 2 users not shown)
Line 1: Line 1:
[[Category:GSOC2012]][[Category:GSOC]]
[[Category:GSOC_2012]][[Category:GSOC_2012_Proposals]]
 
Please note that the wiki page might not contain the latest version of the proposal. Use the Google Melange link to see the authoritative version.
 
[http://www.google-melange.com/gsoc/proposal/review/google/gsoc2012/chelen/1 Chelen's proposal in the Melange]
 
=Improve usability and get rid of little bugs=
=Improve usability and get rid of little bugs=


Scribus is a really powerful tool and allow us to do very professional stuffs. But, sometime, it doesn't behave as expected by the user and it looks unfriendly as you have to redo some part of your work.
The main goal of this project is to improve friendliness.
As this subject suggest, it will not be just one big task but different little ones to improve user-friendliness of Scribus.
The idea that improving usability very well is possible in curing many very little bugs or sometime in adding very little features. That is why I will focus on this goal and improve undo/redo functionalities which can have incorrect behaviour.
During the GSoC, I will focus on two goal describe below : undo-redo and make easier user handling.
 
We can notice that story editor lack of undo/redo but I will not work on this one as this widget should certainly completely change soon.
To perform undo, we have to add the action on a stack where we can "pop" or "push" actions to undo or redo. Qt have already some classes to preform these kinds of actions.
 
As there are always something to do to improve usability, there will not have an exhaustive list of all issues. However, I will do this proposal with those which look to be the most important as user may encounter this regularly. A more important list can be found [[Undo_ToDo|Here]]


==Project description==
==Project description==
Line 13: Line 22:
When we speak about user-friendliness, it also means that Scribus has to do what the user expect it does. We can notice that it remains some bug in undo/redo functionalities.  
When we speak about user-friendliness, it also means that Scribus has to do what the user expect it does. We can notice that it remains some bug in undo/redo functionalities.  


Currently, undo/redo is absent with some functionalities (changing style character for example) or have an abnormal behaviour (with pattern/graphic or about save functionality ). As we can see with those examples, there are some improvement to do in these cases and especially with undo/redo when we resize/rotate a frame or a graphic.
Currently, undo/redo is absent with some functionalities (changing style character for example) or have an abnormal behaviour (with pattern/graphic or about save functionality). First of all, I will have to export undo/redo on text frame done by Cezary [http://bugs.scribus.net/view.php?id=9890 #9890] in version 1.4 to version 1.5.
We can also notice that story editor lack undo/redo functionalities but cezary have already programmed that and will export his work from 1.4 to 1.5.


===Make easier user handling===
===Make easier user handling===


To improve usability of scribus, we have to avoid repetitive actions and quicken access to different linked actions. Even if regular users used to do with these actions, new ones can be disturb by this kind of behaviour as it is a waste of time.
As I can do a lot with Undo/Redo, this part is just in the case I have extra time at the end of the project or after the GSoC.
 
To improve usability of scribus, we have to avoid repetitive actions and quicken access to different linked actions. Even if regular users used to do with these actions, new ones can be disturbed by this kind of behaviour as it is a waste of time.


In this case, we can think there are a lot of different thinks to do but in reality, it is pretty much the same in all different cases. Indeed, whether adding some space after a paragraph or enable/disable pre press or remembering rename or replace and many others, what the user want is just that scribus remember a default behaviour.
In this case, we can think there are a lot of different thinks to do but in reality, it is pretty much the same in all different cases. Indeed, whether adding some space after a paragraph or enable/disable pre press or remembering rename or replace and many others, what the user want is just that scribus remember a default behaviour.


The second case is when the user have to click 10 time to do what he wants or when he has to go in another panel like with contour definition. In all these case, we have to reduce the number of manipulation that the user need to do an action.
The second case is when the user has to click 10 times to do what he wants or when he has to go in another panel like with contour definition. In all these cases, we have to reduce the number of manipulations needed by the user to do an action.


==Implementation==
==Implementation==
Line 28: Line 38:
We can separate this in three parts:
We can separate this in three parts:
   
   
-Studying how is manage undo and the user interface now
*Studying how the undo and the user interface are managed nowadays
    -Reading some part of the code where undo is correctly manage
**Reading some part of the code where undo is correctly managed
    -Collecting information about Undo/Redo framework in Qt
**Collecting information about Undo/Redo framework in Qt
    -Discuss with Scribus team what part of the code have to be improve first either of user interface and undo/redo management
**Discuss with Scribus team what parts of the code have to be improved first for the undo/redo management (before GSoC)
   
   
-Coding new features
*Coding new features
    -Fixing well known bug related to user handling  
**Fixing well known bug related to user handling (extra)
    -Fixing undo/redo management bug
**Fixing undo/redo management bug
    -Improve undo/redo functionalities where it is possible
**Improving undo/redo functionalities where it is possible
    -Add a new control panel for undo/redo to enable user to see and control easily his actions.
**Adding a new control panel for undo/redo to enable user to see and control easily his actions.
**Adding a way to save a succession of command and redo this succession.
 
*Finalisation
**Execution of a bench of test to be sure that this code can be included in the trunk
**Documentation of the code the enable the team to maintain this part of the code
**Merging the code in the scribus trunk
 
===Project deliverables===
 
Here is the full list of what I expect to do.
 
====Undo/Redo====


-Finalisation
*Text
    -Execution of a bench of test to be sure that this code can be include in the trunk
**Export to 1.5 the text frame undo/redo already done by Cezary on 1.4
    -Documentation of the code the enable the team to maintain this part of the code
**Character style modification [http://bugs.scribus.net/view.php?id=10310 #10310]
    -Merging the code in the scribus trunk
 
*Graphic
**EPS graphic [http://bugs.scribus.net/view.php?id=5210 #5210]
**Combine/Split polygons [http://bugs.scribus.net/view.php?id=4718 #4718] and [http://bugs.scribus.net/view.php?id=6220 #6220]
**Rotation, resize of shape [http://bugs.scribus.net/view.php?id=4353 #4353]
 
*Option
**Overprint in PP [http://bugs.scribus.net/view.php?id=4833 #4833]
**Fusion mode in PP [http://bugs.scribus.net/view.php?id=4832 #4832]
**Arrows in PP [http://bugs.scribus.net/view.php?id=10452 #10452]
**Action pdf [http://bugs.scribus.net/view.php?id=3414 #3414]
 
*Layout
**Creation of master page [http://bugs.scribus.net/view.php?id=4820 #4820]
**Import of page [http://bugs.scribus.net/view.php?id=5173 #5173]
**Selection of frame after undo [http://bugs.scribus.net/view.php?id=5075 #5075]
 
*Miscellaneous
**Correct management of save flag after undo [http://bugs.scribus.net/view.php?id=3455 #3455]
**Replay an action [http://bugs.scribus.net/view.php?id=1630 #1630]
**add undo/redo panel
 
====Make user handling easier====
 
If enough time
 
*Remember usual behaviour
**Multiple-duplicate (remember options value as asked on the mailing list)
**locked copy [http://bugs.scribus.net/view.php?id=10468 #10468]
**Master page import [http://bugs.scribus.net/view.php?id=10263 #10263]
**Master page position after switching [http://bugs.scribus.net/view.php?id=10453 #10453]
**Rename/replace style [http://bugs.scribus.net/view.php?id=10455 #10455]
**Pdf options after export [http://bugs.scribus.net/view.php?id=10582 #10582]
**Cursor position after glyph insertion [http://bugs.scribus.net/view.php?id=10584 #10584]
**Add vertical space before/after paragraph
 
 
To do this, data will be separate between data which will be save in the sla file. These data are specifics to one document. And other data saved like in the preference panel and related to all documents. The better can be to add a panel in preference to give this choice to the user and add a default behaviour for user who do not change preferences.
 
 
*Enable user to do things faster
**Add multiple master page [http://bugs.scribus.net/view.php?id=10272 #10272]
**Improve click on spinBox [http://bugs.scribus.net/view.php?id=10303 #10303]
**Align shape [http://bugs.scribus.net/view.php?id=10269 #10269]
 
===Contingency===
As some actions might take more time than expected, I have selected some parts which can be postponed after GSoC.
 
*Add undo/redo panel
:As it really has a place in undo/redo project, I hope I can implement this during the summer
 
*Replay an action
:This is a part which can take a lot of time and it is on the edge of the undo/redo subject.


==Time Line==
==Time Line==


As the main goal of GSoC is to involved student in open source project. There are no reason to wait until June before beginning this project even if I will have more time during the summer.
As the main goal of GSoC is to involve students in open source project. There are no reason to wait until June before beginning this project even if I will have more time during the summer.
To make easier user handling and improve undo/redo management, I will have to discuss all the time with scribus team to be inform about user difficulties and fixing them as a new part of the project.
To make user handling easier and improve undo/redo management, I will have to discuss all the time with scribus team to be informed about user difficulties to be able to fix them as a new part of the project.


April:
April:


-Define a list of main task to improve usability and what should be done for the mid term evaluation.
-Define a list of main tasks to improve usability and what should be done for the mid term evaluation.


-Have a deeper understanding of the undo/redo manager in scribus.
-Have a deeper understanding of the undo/redo management in scribus.


-Fixing one or two bugs to improve my Scribus code base knowledge.
-Fix one or two bugs to improve my Scribus code base knowledge.


May:
May:


-Fixing one undo/redo bug to see what is involved when I will work on that.
-Fix one undo/redo bug to see what is involved when I will work on that.
 
-As this is the month when I take my exams, I prefer not to overload my timetable but I may do more.


-As this is the month when I have my exam, I prefer don't overload my timetable but I may do more.
May 28- May 31:


May 28-June 10:
-Export undo/redo for text frame from 1.4 to 1.5


-Fixing undo/redo issue with shape.
June 1-June 10:
 
-Fix undo/redo issues with text and options actions.


June 10-June 25:
June 10-June 25:


-Fixing undo/redo issue with style.
-Fix undo/redo issues with graphics actions and other miscellaneous actions.


June 25-July 6:
June 25-July 6:


-Be sure that everything is good with undo/redo and improve performance
-Be sure that everything is good with undo/redo and improve performance.


July 6-July 10:
July 6-July 10:


-Redaction of the mid term evaluation
-Redaction of the mid term evaluation.


July 10-July 24:
July 10-July 24:


-Enable Scribus to remember user default behaviour
-Enable Scribus to remember user default behaviour.


July 24-August 7:
July 24-August 7:


-Make faster user actions on scribus
-Make faster user actions on scribus.


August 7-August 13:
August 7-August 13:


-Final test and merge with scribus trunk
-Final test and merge with scribus trunk.


13-30 August:
13-30 August:


-Pencil down: Preparing the final evaluation and polish all the work
-Pencil down: Preparing the final evaluation and polish all the work.


==After GSoC==
==After GSoC==


I really want to work with Scribus team even after GSoC and I will continue to fix bug and help you in all these tasks. Also, I have some idea to improve Scribus but I can't do it in GSoC as the timeline is to short or I may need a deeper knowledge of the code base.
I really want to work with Scribus team even after GSoC and I will continue to fix bug and help you in all these tasks. Also, I have some ideas to improve Scribus but I cannot do it in GSoC as the timeline is to short or I may need a deeper knowledge of the code base.


For example:
For example:


-When I used Scribus, I used to work with other persons and it is really inefficient to work on different computer and merge difference files at the end. I think it could be great to enable scribus to work through the network. Like googledoc but with scribus. This project have to mature but Qt supply a lot of class to do network stuff.
-When I used Scribus, I used to work with other persons and it is really inefficient to work on different computers and merge different files at the end. I think it could be great to enable scribus to work through the network. Like googledoc but with scribus. This project has to mature but Qt supplies a lot of classes to do network stuff.


-Add openMP instruction to make scribus work in parallel and improve its capacities. It have to be add with the multithreading subject.
-Add openMP instructions to make scribus work in parallel and improve its capacities. It has to be added with the multithreading subject.


-Add a way to update scribus automatically on the computer without reinstalling everything.
-Add a way to update scribus automatically on the computer without reinstalling everything.
Line 109: Line 187:
==Biography==
==Biography==


I am Pierrick, second years at Telecom Bretagne a renowned engineering telecommunication school in France.
I am Pierrick, second year at Telecom Bretagne, a renowned engineering telecommunication school in France.


I use Scribus since more than one year to do a newspaper and a magazine.
I have been using Scribus since more than one year to do a newspaper and a magazine.


I have already some experience in developing with C/C++ and Qt sometime for fun, others for school project http://code.google.com/p/qrypt4all/
I have already some experience in developing with C/C++ and Qt sometimes for fun, others for school project http://code.google.com/p/qrypt4all/
As I had work with other guys, I have already use cooperative tools like svn/git.
As I had work with other guys, I have already used cooperative tools like svn/git.


It is the first time I am involved in big open source project like this one. To show my capacities, I have fix two bugs in scribus:  
It is the first time I am involved in a big open source project like this one. To show my capacities, I have fixed two bugs in scribus:  


http://bugs.scribus.net/view.php?id=10571
http://bugs.scribus.net/view.php?id=10571
Line 122: Line 200:
http://bugs.scribus.net/view.php?id=7793
http://bugs.scribus.net/view.php?id=7793


The second one is now merge in scribus trunk.
http://bugs.scribus.net/view.php?id=10269
 
The first and the second now merged in scribus trunk.


I know that GSoC is a real job and I hope to have at least 35h per week on the project
I know that GSoC is a real job and I hope to have at least 35h per week on the project

Latest revision as of 20:19, 20 April 2012


Please note that the wiki page might not contain the latest version of the proposal. Use the Google Melange link to see the authoritative version.

Chelen's proposal in the Melange

Improve usability and get rid of little bugs

The main goal of this project is to improve friendliness. The idea that improving usability very well is possible in curing many very little bugs or sometime in adding very little features. That is why I will focus on this goal and improve undo/redo functionalities which can have incorrect behaviour.

We can notice that story editor lack of undo/redo but I will not work on this one as this widget should certainly completely change soon. To perform undo, we have to add the action on a stack where we can "pop" or "push" actions to undo or redo. Qt have already some classes to preform these kinds of actions.

As there are always something to do to improve usability, there will not have an exhaustive list of all issues. However, I will do this proposal with those which look to be the most important as user may encounter this regularly. A more important list can be found Here

Project description

Undo-redo

When we speak about user-friendliness, it also means that Scribus has to do what the user expect it does. We can notice that it remains some bug in undo/redo functionalities.

Currently, undo/redo is absent with some functionalities (changing style character for example) or have an abnormal behaviour (with pattern/graphic or about save functionality). First of all, I will have to export undo/redo on text frame done by Cezary #9890 in version 1.4 to version 1.5.

Make easier user handling

As I can do a lot with Undo/Redo, this part is just in the case I have extra time at the end of the project or after the GSoC.

To improve usability of scribus, we have to avoid repetitive actions and quicken access to different linked actions. Even if regular users used to do with these actions, new ones can be disturbed by this kind of behaviour as it is a waste of time.

In this case, we can think there are a lot of different thinks to do but in reality, it is pretty much the same in all different cases. Indeed, whether adding some space after a paragraph or enable/disable pre press or remembering rename or replace and many others, what the user want is just that scribus remember a default behaviour.

The second case is when the user has to click 10 times to do what he wants or when he has to go in another panel like with contour definition. In all these cases, we have to reduce the number of manipulations needed by the user to do an action.

Implementation

We can separate this in three parts:

  • Studying how the undo and the user interface are managed nowadays
    • Reading some part of the code where undo is correctly managed
    • Collecting information about Undo/Redo framework in Qt
    • Discuss with Scribus team what parts of the code have to be improved first for the undo/redo management (before GSoC)
  • Coding new features
    • Fixing well known bug related to user handling (extra)
    • Fixing undo/redo management bug
    • Improving undo/redo functionalities where it is possible
    • Adding a new control panel for undo/redo to enable user to see and control easily his actions.
    • Adding a way to save a succession of command and redo this succession.
  • Finalisation
    • Execution of a bench of test to be sure that this code can be included in the trunk
    • Documentation of the code the enable the team to maintain this part of the code
    • Merging the code in the scribus trunk

Project deliverables

Here is the full list of what I expect to do.

Undo/Redo

  • Text
    • Export to 1.5 the text frame undo/redo already done by Cezary on 1.4
    • Character style modification #10310
  • Layout
    • Creation of master page #4820
    • Import of page #5173
    • Selection of frame after undo #5075
  • Miscellaneous
    • Correct management of save flag after undo #3455
    • Replay an action #1630
    • add undo/redo panel

Make user handling easier

If enough time

  • Remember usual behaviour
    • Multiple-duplicate (remember options value as asked on the mailing list)
    • locked copy #10468
    • Master page import #10263
    • Master page position after switching #10453
    • Rename/replace style #10455
    • Pdf options after export #10582
    • Cursor position after glyph insertion #10584
    • Add vertical space before/after paragraph


To do this, data will be separate between data which will be save in the sla file. These data are specifics to one document. And other data saved like in the preference panel and related to all documents. The better can be to add a panel in preference to give this choice to the user and add a default behaviour for user who do not change preferences.


  • Enable user to do things faster

Contingency

As some actions might take more time than expected, I have selected some parts which can be postponed after GSoC.

  • Add undo/redo panel
As it really has a place in undo/redo project, I hope I can implement this during the summer
  • Replay an action
This is a part which can take a lot of time and it is on the edge of the undo/redo subject.

Time Line

As the main goal of GSoC is to involve students in open source project. There are no reason to wait until June before beginning this project even if I will have more time during the summer. To make user handling easier and improve undo/redo management, I will have to discuss all the time with scribus team to be informed about user difficulties to be able to fix them as a new part of the project.

April:

-Define a list of main tasks to improve usability and what should be done for the mid term evaluation.

-Have a deeper understanding of the undo/redo management in scribus.

-Fix one or two bugs to improve my Scribus code base knowledge.

May:

-Fix one undo/redo bug to see what is involved when I will work on that.

-As this is the month when I take my exams, I prefer not to overload my timetable but I may do more.

May 28- May 31:

-Export undo/redo for text frame from 1.4 to 1.5

June 1-June 10:

-Fix undo/redo issues with text and options actions.

June 10-June 25:

-Fix undo/redo issues with graphics actions and other miscellaneous actions.

June 25-July 6:

-Be sure that everything is good with undo/redo and improve performance.

July 6-July 10:

-Redaction of the mid term evaluation.

July 10-July 24:

-Enable Scribus to remember user default behaviour.

July 24-August 7:

-Make faster user actions on scribus.

August 7-August 13:

-Final test and merge with scribus trunk.

13-30 August:

-Pencil down: Preparing the final evaluation and polish all the work.

After GSoC

I really want to work with Scribus team even after GSoC and I will continue to fix bug and help you in all these tasks. Also, I have some ideas to improve Scribus but I cannot do it in GSoC as the timeline is to short or I may need a deeper knowledge of the code base.

For example:

-When I used Scribus, I used to work with other persons and it is really inefficient to work on different computers and merge different files at the end. I think it could be great to enable scribus to work through the network. Like googledoc but with scribus. This project has to mature but Qt supplies a lot of classes to do network stuff.

-Add openMP instructions to make scribus work in parallel and improve its capacities. It has to be added with the multithreading subject.

-Add a way to update scribus automatically on the computer without reinstalling everything.

Biography

I am Pierrick, second year at Telecom Bretagne, a renowned engineering telecommunication school in France.

I have been using Scribus since more than one year to do a newspaper and a magazine.

I have already some experience in developing with C/C++ and Qt sometimes for fun, others for school project http://code.google.com/p/qrypt4all/ As I had work with other guys, I have already used cooperative tools like svn/git.

It is the first time I am involved in a big open source project like this one. To show my capacities, I have fixed two bugs in scribus:

http://bugs.scribus.net/view.php?id=10571

http://bugs.scribus.net/view.php?id=7793

http://bugs.scribus.net/view.php?id=10269

The first and the second now merged in scribus trunk.

I know that GSoC is a real job and I hope to have at least 35h per week on the project

Contact Information

Name: Pierrick Brunet

irc: Chelen

mail: pierrick.brunet@telecom-bretagne.eu

skype: Pierrick912