After an evaluation, GNOME has moved from Bugzilla to GitLab. Learn more about GitLab.
No new issues can be reported in GNOME Bugzilla anymore.
To report an issue in a GNOME project, go to GNOME GitLab.
Do not go to GNOME Gitlab for: Bluefish, Doxygen, GnuCash, GStreamer, java-gnome, LDTP, NetworkManager, Tomboy.
Bug 783793 - Document "To Do" bar (calendar and task items with deadlines displayed in the mail view)
Document "To Do" bar (calendar and task items with deadlines displayed in the...
Status: RESOLVED FIXED
Product: evolution
Classification: Applications
Component: User Documentation
3.25.x (obsolete)
Other Linux
: Normal enhancement
: ---
Assigned To: André Klapper
Evolution QA team
Depends on:
Blocks:
 
 
Reported: 2017-06-14 17:57 UTC by André Klapper
Modified: 2017-08-04 17:00 UTC
See Also:
GNOME target: ---
GNOME version: ---


Attachments
todo-bar.png (99.60 KB, image/png)
2017-07-31 09:56 UTC, Milan Crha
Details
3.25.4 screenshot (111.11 KB, image/png)
2017-08-04 13:55 UTC, André Klapper
Details

Description André Klapper 2017-06-14 17:57:01 UTC
See https://bugzilla.gnome.org/show_bug.cgi?id=266621#c8
Comment 1 Milan Crha 2017-07-10 09:45:18 UTC
From bug #266621 comment #8:
> @mcrha: Would it be possible to get a screenshot attached to bug 783793? TIA

Hmm, such thing would expose my private calendar events and tasks, or show it particularly empty. Not talking about mails.
Comment 2 David Dreggors 2017-07-27 14:16:19 UTC
Maybe open screenshot in gimp and use blur tool on calendar items?

That is what most of us do when we want to show examples but need to obscure the private bits. ;-)
Comment 3 André Klapper 2017-07-28 14:43:24 UTC
@mcrha: What is the difference of this "To Do bar" to the existing "Tasks" pane on the right (in LTR) in the calendar view? I still have no idea how it looks and what it can do and where exactly the setting ""Show To _Do Bar"" is available and what is a "main window" and what is a "sub-window" when looking at https://git.gnome.org/browse/evolution/commit/?id=f733f3a
Comment 4 David Dreggors 2017-07-28 15:32:55 UTC
Here is an example I posted previously in my bug report (https://bugzilla.gnome.org/show_bug.cgi?id=266621):

https://bug266621.bugzilla-attachments.gnome.org/attachment.cgi?id=352523
Comment 5 David Dreggors 2017-07-28 15:35:10 UTC
(In reply to André Klapper from comment #3)
> @mcrha: What is the difference of this "To Do bar" to the existing "Tasks"
> pane on the right (in LTR) in the calendar view? I still have no idea how it
> looks and what it can do and where exactly the setting ""Show To _Do Bar""
> is available and what is a "main window" and what is a "sub-window" when
> looking at https://git.gnome.org/browse/evolution/commit/?id=f733f3a

Note that is how it looks in Thunderbird, it will probably be slightly different in Evolution but that should give you an idea
Comment 6 André Klapper 2017-07-28 16:53:28 UTC
@David: This task is about documenting *existing* functionality in Evolution. It is not about discussing potential features or designs in Evolution.
Comment 7 David Dreggors 2017-07-28 17:04:29 UTC
@Andre: You asked for a screenshot, I showed you one.
Comment 8 David Dreggors 2017-07-28 17:04:45 UTC
@Andre: You asked for a screenshot, I showed you one.
Comment 9 André Klapper 2017-07-30 13:05:59 UTC
@David: I have not seen any screenshot from Evolution 3.25 in this task.
This task is about documenting Evolution. Not other software. See comment 6.
Comment 10 David Dreggors 2017-07-30 13:23:58 UTC
@Andre: I understand that is is not evolution, I covered that in my original comments above. I offered this screenshot to give you an *idea* of what it will be in evolution as this was the requested feature. I am the original requester and this is what I asked for to be created in Evolution.

You asked:

(In reply to André Klapper from comment #3)
> @mcrha: What is the difference of this "To Do bar" to the existing "Tasks"
> pane on the right (in LTR) in the calendar view? 

I am answering that question by giving you an example of what exactly a "To Do bar" is. Seeing as how this feature was modeled after that software's "To Do bar" you should get a rough idea. :-)
Comment 11 André Klapper 2017-07-31 09:42:41 UTC
I understand that. However I do not need a rough idea. 
I need proper user documentation based on existing actual code.
Comment 12 Milan Crha 2017-07-31 09:56:55 UTC
Created attachment 356628 [details]
todo-bar.png

(In reply to André Klapper from comment #3)
> @mcrha: What is the difference of this "To Do bar" to the existing "Tasks"
> pane on the right (in LTR) in the calendar view?

- it shows both events and tasks
- it is visible in the Mail view, thus no need to have opened two windows and
  switch between them
- it shows events/tasks for the next 7 days

> I still have no idea how it looks

See the attached in-evolution screen shot with some limited events/tasks there. Those red under the 'Today' are overdue, see the little date/time before their name.

> what it can do

Show, add, edit and remove what is there. It has some context menu there as well. Which calendars/task lists are considered depends on those enabled in the Calendars view and the Tasks view.

> where exactly the setting ""Show To _Do Bar"" is available

Ha, I'd expect it's the most obvious thing. Menu View->Layout->Show To Do Bar.

> what is a "main window" and what is a "sub-window"

Okay, I see. The Main window (in my terminology) is the first window which had been opened when evolution was run. The sub-window is a window which had been opened after the main window, like with Menu File->New Window. Maybe this exact bit is not that important and you can safely skip it in the documentation.

(In reply to David Dreggors from comment #10)
> ...software's "To Do bar" you should get a rough idea.

I agree with Andre that having a screen shot from another application, even the work had been inspired by it, doesn't give only rough idea, but can be misleading, because the correct look & feel is somewhat far from the Thunderbird's (I never planned to have 1:1 feature with Thunderbird). Remember, Andre is writing the documentation for the users, where the confusion should be avoided.
Comment 13 André Klapper 2017-07-31 15:57:05 UTC
Thanks a lot Milan!!


Note to myself: 

Looking at https://help.gnome.org/users/evolution/stable/ I don't have a good idea where this might fit. Yet. :-/

Should be covered in https://help.gnome.org/users/evolution/stable/intro-main-window.html with a new screenshot.

Should get linked from https://help.gnome.org/users/evolution/stable/calendar-layout.html and https://help.gnome.org/users/evolution/stable/tasks-display-settings.html
Comment 14 David Dreggors 2017-07-31 16:29:04 UTC
(In reply to André Klapper from comment #13)
> Thanks a lot Milan!!
> 
> 
> Note to myself: 
> 
> Looking at https://help.gnome.org/users/evolution/stable/ I don't have a
> good idea where this might fit. Yet. :-/
> 
> Should be covered in
> https://help.gnome.org/users/evolution/stable/intro-main-window.html with a
> new screenshot.
> 
> Should get linked from
> https://help.gnome.org/users/evolution/stable/calendar-layout.html and
> https://help.gnome.org/users/evolution/stable/tasks-display-settings.html

and possibly 
https://help.gnome.org/users/evolution/stable/mail-layout-changing.html.en
Comment 15 David Dreggors 2017-07-31 16:33:03 UTC
(In reply to Milan Crha from comment #12)

> 
> (In reply to David Dreggors from comment #10)
> > ...software's "To Do bar" you should get a rough idea.
> 
> I agree with Andre that having a screen shot from another application, even
> the work had been inspired by it, doesn't give only rough idea, but can be
> misleading, because the correct look & feel is somewhat far from the
> Thunderbird's (I never planned to have 1:1 feature with Thunderbird).
> Remember, Andre is writing the documentation for the users, where the
> confusion should be avoided.

Fair enough, I was not intending to muddy the waters, I was just trying to give a rough idea of what it is and what id does. The screenshot you posted is somewhat similar to the one I posted from Thunderbird. However I do see your points.
Comment 16 André Klapper 2017-08-04 13:55:27 UTC
Created attachment 356964 [details]
3.25.4 screenshot

To replace https://help.gnome.org/users/evolution/stable/figures/window-overview-layers.png
Comment 17 André Klapper 2017-08-04 17:00:24 UTC
Covered for 3.25.90 in git commit 1b1c54ae2ea45c1e366c3f79865c78fd7d2d7938