Merge pull request #3200 from obsidian-tasks-group/docs-date-editing

docs: Add page on editing dates

Author: claremacrae

docs/Editing/About Editing.md

@@ -19,5 +19,7 @@ Tasks has a growing number of ways to conveniently add data to your task lines.
 
 - [[Toggling and Editing Statuses]]
   - All the ways to edit task statuses.
+- [[Editing Dates]]
+  - All the ways to edit dates on tasks.
 - [[Postponing]]
   - Easy deferring or snoozing of due, scheduled and start dates.

docs/Editing/Editing Dates.md

@@ -0,0 +1,73 @@
+---
+publish: true
+---
+
+# Editing Dates
+
+<span class="related-pages">#feature/dates</span>
+
+## Summary
+
+Tasks supports a range of date properties for managing your tasks: see [[Dates]].
+
+This page describes ways to add, edit and remove date values on tasks.
+
+There is a [[#Date-picker on task dates]] and a [[#Context menu on task dates]], or you can use various [[#other date-editing options]].
+
+## Date-picker on task dates
+
+> [!released]
+> Introduced in Tasks X.Y.Z.
+
+**Left-click on any task date field** in **Reading mode** and **Tasks query search results** to use a date-picker and calendar to edit or remove a date.
+
+![Hover over a date in Read mode or Tasks query search results](../images/date-picker-1.png)
+<span class="caption">Hover over a date in Read mode or Tasks query search results</span>
+
+![In the date-picker, you can easily select a new date, or clear the current one](../images/date-picker-2.png)
+<span class="caption">In the date-picker, you can easily select a new date, or clear the current one</span>
+
+| Where                         | Viewing Mode | Works? |
+| ----------------------------- | ------------ | ------ |
+| Task lines in markdown files  | Source mode  | ❌     |
+| Task lines in markdown files  | Live Preview | ❌     |
+| Task lines in markdown files  | Reading mode | ✅     |
+| In Tasks query search results | Live Preview | ✅     |
+| In Tasks query search results | Reading mode | ✅     |
+
+## Context menu on task dates
+
+> [!released]
+> Introduced in Tasks 7.10.0.
+
+**Right-click on any task date field** in **Reading mode** and **Tasks query search results** to:
+
+- postpone Start, Scheduled and Due dates
+- advance Created, Cancelled and Done dates
+
+![Hover over a date in Read mode or Tasks query search results](../images/date-context-menu-1.png)
+<span class="caption">Hover over a date in Read mode or Tasks query search results</span>
+
+![Chose an option from the context menu](../images/date-context-menu-2.png)
+<span class="caption">Chose an option from the context menu</span>
+
+| Where                         | Viewing Mode | Works? |
+| ----------------------------- | ------------ | ------ |
+| Task lines in markdown files  | Source mode  | ❌     |
+| Task lines in markdown files  | Live Preview | ❌     |
+| Task lines in markdown files  | Reading mode | ✅     |
+| In Tasks query search results | Live Preview | ✅     |
+| In Tasks query search results | Reading mode | ✅     |
+
+## Other date-editing options
+
+In **Editing mode** (both Source mode and Live Preview) the options are:
+
+- Type the dates yourself.
+- Use [[Auto-Suggest]] to add emojis and a range of convenient dates.
+- Using the `Create or edit Task` command to access the [[Create or edit Task]] modal/dialog.
+
+In **Reading mode** and **Tasks query search results** the options are:
+
+- Click or right-click ⏩ to use the [[Postponing|Postpone]] button.
+- Click the Pencil icon  (📝) to use the [[Create or edit Task]] modal/dialog.

docs/What is New/Changelog.md

@@ -12,16 +12,16 @@ _In recent [Tasks releases](https://github.com/obsidian-tasks-group/obsidian-tas
 
 ## 7.x releases
 
+- X.Y.Z:
+  - Add [[Editing Dates#Date-picker on task dates|date picker]] to Reading mode and Tasks query search results.
 - 7.13.0:
   - Add [[Create or edit Task#Date picker|date picker]] to the Edit Task modal.
 - 7.12.0:
   - Add [[Layout#Hide and Show Tree|display of nested tasks]] in search results, with `show tree`
 - 7.11.0:
   - Add [[Sorting#Random sorting|random sorting]], with `sort by random`
 - 7.10.0:
-  - Right-click on any task date field in Reading and Query Results views to:
-    - postpone Start, Scheduled and Due dates
-    - advance Created, Cancelled and Done dates
+  - Add [[Editing Dates#Context menu on task dates|right-click context menu on dates]] in Reading and Query Results views.
 - 7.9.0:
   - Add [[Layout|hide and show]] instructions `hide on completion` and `show on completion`.
   - Add one-click support for the [[Border Theme|Border]] theme.