GNOME.org
 

[gnome-todo] New help pages

commit f0d7343b62a5bf68b369cc771fe930debda5eeb8
Author: Lorenz Wildberg <lorenz wild-fisch de>
Date:   Mon Jul 5 13:21:06 2021 +0200

    New help pages
    
    Todo has now an entry in the help system.
    You can open it also through a button in the primary menu.

 help/C/add-notes.page                 |  18 ++++++++++++++
 help/C/archive.page                   |  26 ++++++++++++++++++++
 help/C/assign-color.page              |  17 ++++++++++++++
 help/C/assign-date.page               |  18 ++++++++++++++
 help/C/contributing.page              |  21 +++++++++++++++++
 help/C/create-tasklists.page          |  19 +++++++++++++++
 help/C/create-tasks.page              |  24 +++++++++++++++++++
 help/C/delete-tasklist.page           |  23 ++++++++++++++++++
 help/C/execute-task.page              |  13 ++++++++++
 help/C/figures/open-menu-symbolic.svg |   8 +++++++
 help/C/figures/org.gnome.Todo.svg     |  18 ++++++++++++++
 help/C/figures/task-list.png          | Bin 0 -> 62750 bytes
 help/C/figures/view-more-symbolic.svg |   8 +++++++
 help/C/give-star.page                 |  15 ++++++++++++
 help/C/index.page                     |  36 ++++++++++++++++++++++++++++
 help/C/overview.page                  |  15 ++++++++++++
 help/C/rename-tasklist.page           |  19 +++++++++++++++
 help/C/rename-tasks.page              |  17 ++++++++++++++
 help/C/support.page                   |  15 ++++++++++++
 help/C/switch-theme.page              |  18 ++++++++++++++
 help/C/workflow.page                  |  43 ++++++++++++++++++++++++++++++++++
 help/meson.build                      |  28 ++++++++++++++++++++++
 meson.build                           |   1 +
 src/gui/gtd-application.c             |  16 ++++++++++++-
 src/gui/menus.ui                      |   4 ++++
 25 files changed, 439 insertions(+), 1 deletion(-)
---
diff --git a/help/C/add-notes.page b/help/C/add-notes.page
new file mode 100644
index 00000000..dc7d9214
--- /dev/null
+++ b/help/C/add-notes.page
@@ -0,0 +1,18 @@
+<page xmlns="http://projectmallard.org/1.0/";
+      type="topic"
+      id="add_notes">
+
+  <info>
+    <link type="guide" xref="index#task"/>
+  </info>
+
+  <title>Add notes to a task</title>
+
+  <steps>
+    <item><p>Expand the task by clicking on it in the list.</p></item>
+    <item><p>Write something in the textfield labeled with <gui style="button">Notes</gui>.</p></item>
+  </steps>
+
+  <p>You can edit this later whenever you want.</p>
+
+</page>
diff --git a/help/C/archive.page b/help/C/archive.page
new file mode 100644
index 00000000..936e633d
--- /dev/null
+++ b/help/C/archive.page
@@ -0,0 +1,26 @@
+<page xmlns="http://projectmallard.org/1.0/";
+      type="topic"
+      id="archive">
+
+  <info>
+    <link type="guide" xref="index#tasklists"/>
+  </info>
+
+  <title>Archive a task list</title>
+
+
+  <steps>
+    <item><p>Navigate to your task list.</p></item>
+    <item><p>Open the menu ( <media its:translate="no" type="image" 
src="figures/view-more-symbolic.svg"></media> ) on the right side of the headerbar.</p></item>
+    <item><p>Click on the <gui style="button">Archive" button to archive your task list.</p></item>
+  </steps>
+
+  <p>You can access your archived task lists through the <gui>Archived</gui> category in the utility 
pane.</p>
+  <p>From there you can unarchive them:</p>
+
+  <steps>
+    <item><p>Open the menu ( <media its:translate="no" type="image" 
src="figures/view-more-symbolic.svg"></media> ) on the right side of the headerbar.</p></item>
+    <item><p>The <gui style="button">Unarchive</gui> button moves your task list again to all 
others.</p></item>
+  </steps>
+
+</page>
diff --git a/help/C/assign-color.page b/help/C/assign-color.page
new file mode 100644
index 00000000..f7fe033f
--- /dev/null
+++ b/help/C/assign-color.page
@@ -0,0 +1,17 @@
+<page xmlns="http://projectmallard.org/1.0/";
+      type="topic"
+      id="assign_color">
+
+  <info>
+    <link type="guide" xref="index#tasklists"/>
+  </info>
+
+  <title>Assign a color to a task list</title>
+
+  <steps>
+    <item><p>Navigate to your task list.</p></item>
+    <item><p>Open the menu (<media its:translate="no" type="image" 
src="figures/view-more-symbolic.svg"></media>) on the right side of the headerbar.</p></item>
+    <item><p>Choose one of the given colors by clicking on them.</p></item>
+  </steps>
+
+</page>
diff --git a/help/C/assign-date.page b/help/C/assign-date.page
new file mode 100644
index 00000000..561854ae
--- /dev/null
+++ b/help/C/assign-date.page
@@ -0,0 +1,18 @@
+<page xmlns="http://projectmallard.org/1.0/";
+      type="topic"
+      id="assign_date">
+
+  <info>
+    <link type="guide" xref="index#task"/>
+  </info>
+
+  <title>Assign a date to a task</title>
+
+  <steps>
+    <item><p>Expand the task by clicking on it in the list.</p></item>
+    <item><p>Click on the button labeled with <gui style="button">Today</gui>, <gui 
style="button">Tomorrow</gui> or with the arrow icon to assign another date.</p></item>
+  </steps>
+
+  <p>To delete the date, click on the button with the arrow icon and then on <gui 
style="button">None</gui>.</p>
+
+</page>
diff --git a/help/C/contributing.page b/help/C/contributing.page
new file mode 100644
index 00000000..8ce8646e
--- /dev/null
+++ b/help/C/contributing.page
@@ -0,0 +1,21 @@
+<page xmlns="http://projectmallard.org/1.0/";
+      type="topic"
+      id="contributing">
+
+  <info>
+    <link type="guide" xref="index#contribute"/>
+  </info>
+
+  <title>Contribute to GNOME To do</title>
+
+  <p>There are multiple ways of helping to improve GNOME To Do:</p>
+  <list>
+    <item><p>File issues you have encountered while using GNOME To Do</p></item>
+    <item><p>Translate the user interface or help pages of GNOME To Do</p></item>
+    <item><p>Correct issues or implement new features</p></item>
+  </list>
+
+  <p>For filing an issue go to the <link 
href="https://gitlab.gnome.org/gnome/gnome-todo/issues";>issuetracker</link>.</p>
+  <p>And for contributing code or translations go to the <link 
href="https://wiki.gnome.org/action/show/Newcomers";>newcomers guide</link>.</p>
+
+</page>
diff --git a/help/C/create-tasklists.page b/help/C/create-tasklists.page
new file mode 100644
index 00000000..ad016bd1
--- /dev/null
+++ b/help/C/create-tasklists.page
@@ -0,0 +1,19 @@
+<page xmlns="http://projectmallard.org/1.0/";
+      type="topic"
+      id="create_tasklist">
+
+  <info>
+    <link type="guide" xref="index#tasklists"/>
+  </info>
+
+  <title>Create a task list</title>
+
+  <steps>
+    <item><p>Click on the <gui style="button">New List</gui> button in the headerbar.</p></item>
+    <item><p>Type in the name of your task list.</p></item>
+    <item><p>Then hit <keyseq><key>Enter</key></keyseq> or click on <gui style="button">Create 
List</gui>.</p></item>
+  </steps>
+
+  <p>Now you can access your list through the entries in the utility pane.</p>
+
+</page>
diff --git a/help/C/create-tasks.page b/help/C/create-tasks.page
new file mode 100644
index 00000000..6d1d1512
--- /dev/null
+++ b/help/C/create-tasks.page
@@ -0,0 +1,24 @@
+<page xmlns="http://projectmallard.org/1.0/";
+      type="topic"
+      id="create_task">
+
+  <info>
+    <link type="guide" xref="index#task"/>
+  </info>
+
+  <title>Create a Task</title>
+
+  <steps>
+    <item><p>Type the title of the new task in the textfield labeled with <gui style="button">New Task</gui> 
next to + .</p></item>
+    <item><p>Then hit <keyseq><key>Enter</key></keyseq> or click on + to save it.</p></item>
+  </steps>
+
+  <note style="tip">
+    <title>Undoing changes</title>
+    <p>Note that you can always undo deleting a task if you change your mind. Click <gui 
style="button">Undo</gui> on
+    the pop-up notification that appears. But when the popup disappears, you cannot recover it anymore.</p>
+  </note>
+
+  <p>When you want to delete the task, expand the task by clicking on it in the list and then click on <gui 
style="button">Delete</gui>.</p>
+
+</page>
diff --git a/help/C/delete-tasklist.page b/help/C/delete-tasklist.page
new file mode 100644
index 00000000..c4930766
--- /dev/null
+++ b/help/C/delete-tasklist.page
@@ -0,0 +1,23 @@
+<page xmlns="http://projectmallard.org/1.0/";
+      type="topic"
+      id="delete_tasklist">
+
+  <info>
+    <link type="guide" xref="index#tasklists"/>
+  </info>
+
+  <title>Delete a task list</title>
+
+  <note style="tip">
+    <title>Undoing changes</title>
+    <p>Note that you can always undo deleting a task list if you change your mind. Click <gui 
style="button">Undo</gui> on
+    the pop-up notification that appears. But when the popup disappears, you cannot recover it anymore.</p>
+  </note>
+
+  <steps>
+    <item><p>Navigate to your task list.</p></item>
+    <item><p>Open the menu (<media its:translate="no" type="image" 
src="figures/view-more-symbolic.svg"></media>) on the right side of the headerbar.</p></item>
+    <item><p>Then the <gui style="button">Delete</gui> button deletes your task list.</p></item>
+  </steps>
+
+</page>
diff --git a/help/C/execute-task.page b/help/C/execute-task.page
new file mode 100644
index 00000000..0ab178e9
--- /dev/null
+++ b/help/C/execute-task.page
@@ -0,0 +1,13 @@
+<page xmlns="http://projectmallard.org/1.0/";
+      type="topic"
+      id="execute_task">
+
+  <info>
+    <link type="guide" xref="index#task"/>
+  </info>
+
+  <title>Execute a task</title>
+
+  <p>Click on the empty field on the left side of the task in the list, to give it a check. Then it 
disappears from <gui>Inbox</gui>, and similar categories. When the task was in a task list, you can still 
find it there and remove the check to make it again not executed.</p>
+
+</page>
diff --git a/help/C/figures/open-menu-symbolic.svg b/help/C/figures/open-menu-symbolic.svg
new file mode 100644
index 00000000..7f447433
--- /dev/null
+++ b/help/C/figures/open-menu-symbolic.svg
@@ -0,0 +1,8 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<svg height="16px" viewBox="0 0 16 16" width="16px" xmlns="http://www.w3.org/2000/svg";>
+    <g fill="#2e3436">
+        <path d="m 1 2 h 14 v 2 h -14 z m 0 0"/>
+        <path d="m 1 7 h 14 v 2 h -14 z m 0 0"/>
+        <path d="m 1 12 h 14 v 2 h -14 z m 0 0"/>
+    </g>
+</svg>
diff --git a/help/C/figures/org.gnome.Todo.svg b/help/C/figures/org.gnome.Todo.svg
new file mode 100644
index 00000000..401001f5
--- /dev/null
+++ b/help/C/figures/org.gnome.Todo.svg
@@ -0,0 +1,18 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<svg xmlns="http://www.w3.org/2000/svg"; xmlns:xlink="http://www.w3.org/1999/xlink"; width="128px" 
height="128px" viewBox="0 0 128 128" version="1.1">
+<g id="surface818">
+<path style=" stroke:none;fill-rule:nonzero;fill:rgb(52.549022%,36.862746%,23.529412%);fill-opacity:1;" d="M 
28.722656 44 L 99.277344 44 C 104.09375 44 108 47.90625 108 52.722656 L 108 111.277344 C 108 116.09375 
104.09375 120 99.277344 120 L 28.722656 120 C 23.90625 120 20 116.09375 20 111.277344 L 20 52.722656 C 20 
47.90625 23.90625 44 28.722656 44 Z M 28.722656 44 "/>
+<path style=" stroke:none;fill-rule:nonzero;fill:rgb(70.980394%,51.372552%,35.294119%);fill-opacity:1;" d="M 
28.722656 16 L 99.277344 16 C 104.09375 16 108 20.0625 108 25.078125 L 108 106.921875 C 108 111.9375 
104.09375 116 99.277344 116 L 28.722656 116 C 23.90625 116 20 111.9375 20 106.921875 L 20 25.078125 C 20 
20.0625 23.90625 16 28.722656 16 Z M 28.722656 16 "/>
+<path style=" stroke:none;fill-rule:nonzero;fill:rgb(87.058824%,86.666667%,85.490197%);fill-opacity:1;" d="M 
28 78 L 100 78 L 100 108 L 28 108 Z M 28 78 "/>
+<path style=" stroke:none;fill-rule:nonzero;fill:rgb(100%,100%,100%);fill-opacity:1;" d="M 28 22 L 100 22 L 
100 104 L 28 104 Z M 28 22 "/>
+<path 
style="fill:none;stroke-width:4;stroke-linecap:butt;stroke-linejoin:miter;stroke:rgb(23.921569%,21.960784%,27.450982%);stroke-opacity:1;stroke-miterlimit:4;"
 d="M 32.000008 219.999994 L 38.000008 225.999994 L 48.000008 215.999994 " 
transform="matrix(1,0,0,1,7.999992,-155.999994)"/>
+<path style=" stroke:none;fill-rule:nonzero;fill:rgb(75.294119%,74.901962%,73.725492%);fill-opacity:1;" d="M 
64 40 L 88 40 L 88 44 L 64 44 Z M 64 40 "/>
+<path style=" stroke:none;fill-rule:nonzero;fill:rgb(75.294119%,74.901962%,73.725492%);fill-opacity:1;" d="M 
64 64 L 82 64 L 82 68 L 64 68 Z M 64 64 "/>
+<path 
style="fill:none;stroke-width:4;stroke-linecap:butt;stroke-linejoin:miter;stroke:rgb(23.921569%,21.960784%,27.450982%);stroke-opacity:1;stroke-miterlimit:4;"
 d="M 32.000008 217.999995 L 38.000008 223.999995 L 48.000008 213.999995 " 
transform="matrix(1,0,0,1,7.999992,-177.999995)"/>
+<path 
style="fill:none;stroke-width:4;stroke-linecap:butt;stroke-linejoin:miter;stroke:rgb(23.921569%,21.960784%,27.450982%);stroke-opacity:1;stroke-miterlimit:4;"
 d="M 32.000008 219.999996 L 38.000008 225.999996 L 48.000008 215.999996 " 
transform="matrix(1,0,0,1,7.999992,-131.999996)"/>
+<path style=" stroke:none;fill-rule:nonzero;fill:rgb(75.294119%,74.901962%,73.725492%);fill-opacity:1;" d="M 
64 88 L 88 88 L 88 92 L 64 92 Z M 64 88 "/>
+<path style=" stroke:none;fill-rule:nonzero;fill:rgb(60.392159%,60.000002%,58.823532%);fill-opacity:1;" d="M 
44 12 C 41.785156 12 40 13.785156 40 16 L 40 24 L 88 24 L 88 16 C 88 13.785156 86.195312 11.6875 84 12 L 70 
12 L 64 20 L 58 12 Z M 44 12 "/>
+<path 
style="fill:none;stroke-width:4;stroke-linecap:butt;stroke-linejoin:round;stroke:rgb(60.392159%,60.000002%,58.823532%);stroke-opacity:1;stroke-miterlimit:4;"
 d="M 70 184 C 70 187.3125 67.3125 190 64 190 C 60.6875 190 58 187.3125 58 184 C 58 180.6875 60.6875 178 64 
178 C 67.3125 178 70 180.6875 70 184 Z M 70 184 " transform="matrix(1,0,0,1,0,-172)"/>
+<path style=" stroke:none;fill-rule:nonzero;fill:rgb(46.666667%,46.27451%,48.235294%);fill-opacity:1;" d="M 
40 24 L 88 24 L 88 28 L 40 28 Z M 40 24 "/>
+</g>
+</svg>
diff --git a/help/C/figures/task-list.png b/help/C/figures/task-list.png
new file mode 100644
index 00000000..16495fa5
Binary files /dev/null and b/help/C/figures/task-list.png differ
diff --git a/help/C/figures/view-more-symbolic.svg b/help/C/figures/view-more-symbolic.svg
new file mode 100644
index 00000000..6838f201
--- /dev/null
+++ b/help/C/figures/view-more-symbolic.svg
@@ -0,0 +1,8 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<svg height="16px" viewBox="0 0 16 16" width="16px" xmlns="http://www.w3.org/2000/svg";>
+    <g fill="#2e3436">
+        <path d="m 9.992188 2 c 0 1.105469 -0.894532 2 -2 2 c -1.101563 0 -2 -0.894531 -2 -2 s 0.898437 -2 2 
-2 c 1.105468 0 2 0.894531 2 2 z m 0 0"/>
+        <path d="m 9.992188 8 c 0 1.105469 -0.894532 2 -2 2 c -1.101563 0 -2 -0.894531 -2 -2 s 0.898437 -2 2 
-2 c 1.105468 0 2 0.894531 2 2 z m 0 0"/>
+        <path d="m 9.992188 14 c 0 1.105469 -0.894532 2 -2 2 c -1.101563 0 -2 -0.894531 -2 -2 s 0.898437 -2 
2 -2 c 1.105468 0 2 0.894531 2 2 z m 0 0"/>
+    </g>
+</svg>
diff --git a/help/C/give-star.page b/help/C/give-star.page
new file mode 100644
index 00000000..c95c64e2
--- /dev/null
+++ b/help/C/give-star.page
@@ -0,0 +1,15 @@
+<page xmlns="http://projectmallard.org/1.0/";
+      type="topic"
+      id="give_star">
+
+  <info>
+    <link type="guide" xref="index#task"/>
+  </info>
+
+  <title>Give a star to a task</title>
+
+  <p>Sometimes you have tasks with a very high priority or want to find them easier in a long list. In that 
case you can give tasks a star.</p>
+
+  <p>Click on the small star on the right side of the task in the list to toggle its state. When it is 
filled you have starred it.</p>
+
+</page>
diff --git a/help/C/index.page b/help/C/index.page
new file mode 100644
index 00000000..5da59cf0
--- /dev/null
+++ b/help/C/index.page
@@ -0,0 +1,36 @@
+<page xmlns="http://projectmallard.org/1.0/";
+      xmlns:its="http://www.w3.org/2005/11/its";
+      type="guide"
+      id="index">
+
+  <info>
+    <desc>GNOME To Do is a simple app, with that you can create, process and manage your tasks, to raise 
your productivity. Also you can synchronize your tasks through your online accounts, so you can check them on 
all your devices.</desc>
+  </info>
+
+  <title>
+    <media type="image" its:translatable="no" src="figures/org.gnome.Todo.svg" width="48" 
height="48"></media>
+    <span>GNOME To Do</span>
+  </title>
+
+  <p>A simple to-do app for GNOME.</p>
+
+  <section id="start" style="2column">
+    <title>Getting Started</title>
+  </section>
+
+  <section id="task" style="2column">
+    <title>Manage Tasks</title>
+  </section>
+
+  <section id="tasklists" style="2column">
+    <title>Manage Task Lists</title>
+  </section>
+
+  <section id="prob" style="2column">
+    <title>Common Problems</title>
+  </section>
+
+  <section id="contribute" style="2column">
+    <title>Contributing and getting support</title>
+  </section>
+</page>
diff --git a/help/C/overview.page b/help/C/overview.page
new file mode 100644
index 00000000..6c1a203e
--- /dev/null
+++ b/help/C/overview.page
@@ -0,0 +1,15 @@
+<page xmlns="http://projectmallard.org/1.0/";
+      type="topic"
+      id="overview">
+
+  <info>
+    <link type="guide" xref="index#start"/>
+  </info>
+
+  <title>Overview</title>
+
+
+
+  <p>The user interface of GNOME To Do is composed of the utility pane on the left and the tasks in lists on 
the right. You can let you show your tasks in different modes. They can be selected through the utility pane. 
<gui>Inbox</gui> contains all tasks which have no date assigned to them and are not in a task list, 
<gui>Today</gui> all tasks with the date of today and <gui>Next 7 Days</gui> all tasks assigned to one of the 
next seven days. <gui>All</gui> shows all tasks in a chronological order and <gui>Archived</gui> archived 
task lists. At least there are also your custom task lists</p>
+
+</page>
diff --git a/help/C/rename-tasklist.page b/help/C/rename-tasklist.page
new file mode 100644
index 00000000..7eb29009
--- /dev/null
+++ b/help/C/rename-tasklist.page
@@ -0,0 +1,19 @@
+<page xmlns="http://projectmallard.org/1.0/";
+      type="topic"
+      id="rename_tasklist">
+
+  <info>
+    <link type="guide" xref="index#tasklists"/>
+  </info>
+
+  <title>Rename a task list</title>
+
+  <steps>
+    <item><p>Navigate to your task list.</p></item>
+    <item><p>Open the menu (<media its:translate="no" type="image" 
src="figures/view-more-symbolic.svg"></media>) on the right side of the headerbar.</p></item>
+    <item><p>Click on the <gui style="button">Rename</gui> button.</p></item>
+    <item><p>Type in the new name.</p></item>
+    <item><p>Hit <keyseq><key>Enter</key></keyseq> or click <gui style="button">Rename</gui>.</p></item>
+  </steps>
+
+</page>
diff --git a/help/C/rename-tasks.page b/help/C/rename-tasks.page
new file mode 100644
index 00000000..d5bcb01f
--- /dev/null
+++ b/help/C/rename-tasks.page
@@ -0,0 +1,17 @@
+<page xmlns="http://projectmallard.org/1.0/";
+      type="topic"
+      id="rename_task">
+
+  <info>
+    <link type="guide" xref="index#task"/>
+  </info>
+
+  <title>Rename a Task</title>
+
+  <steps>
+    <item><p>Go to the title of the task in the list, the cursor should change then.</p></item>
+    <item><p>Click on it, and then begin renaming it.</p></item>
+    <item><p>When you are ready, hit <keyseq><key>Enter</key></keyseq>.</p></item>
+  </steps>
+
+</page>
diff --git a/help/C/support.page b/help/C/support.page
new file mode 100644
index 00000000..e06dff55
--- /dev/null
+++ b/help/C/support.page
@@ -0,0 +1,15 @@
+<page xmlns="http://projectmallard.org/1.0/";
+      type="topic"
+      id="support">
+
+  <info>
+    <link type="guide" xref="index#contribute"/>
+  </info>
+
+  <title>Getting support</title>
+
+  <p>In the <link href="https://wiki.gnome.org/apps/todo";>wiki</link> of GNOME To Do you can read more.</p>
+  <p>When you have questions, ask them on <link href="https://discourse.gnome.org/tag/todo";>gnome 
discourse</link>.</p>
+  <p>You can also get in conversation with the developers of GNOME To Do by joining the <link 
href="https://gnome.element.io/#/room/#gnome-todo:gnome.org";>matrix channel</link>.</p>
+
+</page>
diff --git a/help/C/switch-theme.page b/help/C/switch-theme.page
new file mode 100644
index 00000000..7bddea0c
--- /dev/null
+++ b/help/C/switch-theme.page
@@ -0,0 +1,18 @@
+<page xmlns="http://projectmallard.org/1.0/";
+      type="topic"
+      id="switch_theme">
+
+  <info>
+    <link type="guide" xref="index#prob"/>
+  </info>
+
+  <title>Switch to the dark theme</title>
+
+  <p>When you are in a dark environment, for example at night, a dark theme can be much more comfortable for 
the eyes.</p>
+
+  <steps>
+    <item><p>Open the menu ( <media its:translate="no" type="image" 
src="figures/open-menu-symbolic.svg"></media> ) on the right side of the headerbar.</p></item>
+    <item><p>Click on the dark or light circle, and the theme switches to it.</p></item>
+  </steps>
+
+</page>
diff --git a/help/C/workflow.page b/help/C/workflow.page
new file mode 100644
index 00000000..3538f344
--- /dev/null
+++ b/help/C/workflow.page
@@ -0,0 +1,43 @@
+<page xmlns="http://projectmallard.org/1.0/";
+      type="topic"
+      id="workflow">
+
+  <info>
+    <link type="guide" xref="index#start"/>
+  </info>
+
+  <title>Workflow</title>
+
+  <p>Managing tasks is very personal. Therefore GNOME To Do only ships with a default Workflow that can be 
altered to the needs of the user.</p>
+
+  <section>
+    <title>Task lifecycle</title>
+    <p>Tasks follow a lifecycle that consists of 3 phases:</p>
+
+    <steps>
+      <item><p>Capture</p></item>
+      <item><p>Processing</p></item>
+      <item><p>Execution</p></item>
+    </steps>
+
+    <p>Each phase changes the state of the task, starting from the uncaptured state, leading up to the task 
completion.</p>
+  </section>
+
+  <section>
+    <title>1. Capturing</title>
+    <p>Capturing a task is the act of storing the task in a permanent storage - your hard drive.</p>
+    <p>Captured tasks go to the inbox, which is the list of unprocessed tasks.</p>
+  </section>
+
+  <section>
+    <title>2. Processing</title>
+    <p>Processing a task consists of moving it to an appropriate task list, or doing it right away if it's a 
trivial task, or even throwing it in the wastebasket if you don't plan on doing it.</p>
+    <p>Optionally, adding more description, setting an end date, and marking it as important are done in 
this step.</p>
+  </section>
+
+  <section>
+    <title>3. Executing</title>
+    <p>Executing a task is what leads the task to its conclusion.</p>
+  </section>
+
+</page>
diff --git a/help/meson.build b/help/meson.build
new file mode 100644
index 00000000..8c60f89f
--- /dev/null
+++ b/help/meson.build
@@ -0,0 +1,28 @@
+gnome_todo_help_pages = [
+  'index.page',
+  'add-notes.page',
+  'archive.page',
+  'assign-color.page',
+  'assign-date.page',
+  'contributing.page',
+  'create-tasklists.page',
+  'create-tasks.page',
+  'delete-tasklist.page',
+  'execute-task.page',
+  'give-star.page',
+  'overview.page',
+  'rename-tasks.page',
+  'rename-tasklist.page',
+  'support.page',
+  'switch-theme.page',
+  'workflow.page'
+]
+
+gnome_todo_help_media = [
+  'figures/org.gnome.Todo.svg'
+]
+
+gnome.yelp(meson.project_name(),
+  sources: gnome_todo_help_pages,
+  media: gnome_todo_help_media
+)
diff --git a/meson.build b/meson.build
index c5566334..8c0352e6 100644
--- a/meson.build
+++ b/meson.build
@@ -173,6 +173,7 @@ subdir('src')
 subdir('data')
 subdir('po')
 subdir('tests')
+subdir('help')
 
 enable_documentation = get_option('documentation')
 if enable_documentation
diff --git a/src/gui/gtd-application.c b/src/gui/gtd-application.c
index 85aed88b..83a760c0 100644
--- a/src/gui/gtd-application.c
+++ b/src/gui/gtd-application.c
@@ -63,6 +63,10 @@ static void           gtd_application_quit                        (GSimpleAction
                                                                    GVariant             *parameter,
                                                                    gpointer              user_data);
 
+static void           gtd_application_show_help                        (GSimpleAction        *simple,
+                                                                   GVariant             *parameter,
+                                                                   gpointer              user_data);
+
 G_DEFINE_TYPE (GtdApplication, gtd_application, GTK_TYPE_APPLICATION)
 
 static GOptionEntry cmd_options[] = {
@@ -75,7 +79,8 @@ static const GActionEntry gtd_application_entries[] = {
   { "activate", gtd_application_activate_action },
   { "start-client", gtd_application_start_client },
   { "about",  gtd_application_show_about },
-  { "quit",   gtd_application_quit }
+  { "quit",   gtd_application_quit },
+  { "help",   gtd_application_show_help }
 };
 
 static void
@@ -145,6 +150,15 @@ gtd_application_quit (GSimpleAction *simple,
   gtk_window_destroy (self->window);
 }
 
+static void
+gtd_application_show_help (GSimpleAction *simple,
+                           GVariant      *parameter,
+                           gpointer       user_data)
+{
+  GtdApplication *self = GTD_APPLICATION (user_data);
+  gtk_show_uri (GTK_WINDOW (self->window) , "help:gnome-todo", GDK_CURRENT_TIME);
+}
+
 GtdApplication *
 gtd_application_new (void)
 {
diff --git a/src/gui/menus.ui b/src/gui/menus.ui
index 18e57ee0..99e29b32 100644
--- a/src/gui/menus.ui
+++ b/src/gui/menus.ui
@@ -9,6 +9,10 @@
     </section>
 
     <section>
+      <item>
+        <attribute name="label" translatable="yes">_Help</attribute>
+        <attribute name="action">app.help</attribute>
+      </item>
       <item>
         <attribute name="label" translatable="yes">_About To Do</attribute>
         <attribute name="action">app.about</attribute>
[Date Prev][Date Next]   [Thread Prev][Thread Next]   [Thread Index] [Date Index] [Author Index]