From a9441da0cd3d0ab0de7b98aa9f54fb5048581ac1 Mon Sep 17 00:00:00 2001 From: Clare Macrae Date: Fri, 16 Feb 2024 09:06:00 +0000 Subject: [PATCH] docs: Add more links to 'Finding unread emojis' --- docs/Editing/Auto-Suggest.md | 10 ++++++++-- docs/Getting Started/Getting Started.md | 5 ++++- docs/Reference/Task Formats/About Task Formats.md | 1 + 3 files changed, 13 insertions(+), 3 deletions(-) diff --git a/docs/Editing/Auto-Suggest.md b/docs/Editing/Auto-Suggest.md index 3213e2e155..b56c90fbf2 100644 --- a/docs/Editing/Auto-Suggest.md +++ b/docs/Editing/Auto-Suggest.md @@ -127,9 +127,15 @@ As soon as it finds any unrecognised text, it stops reading, and ignores any emo > [!warning] > Mixing any descriptive text in amongst the emojis and their values **will cause emojis before the descriptive text to not be recognised by Tasks, and not be searchable**. -See the next section for how to check your tasks, as you start using this powerful feature. +We are tracking this ordering limitation in [issue #1505](https://github.com/obsidian-tasks-group/obsidian-tasks/issues/1505). -### How can I check that my Task is formatted correctly? +See the next two sections for how to check your tasks, as you start using this powerful feature. + +### How can I find all tasks that may be formatted incorrectly? + +See [[Find tasks with invalid data#Finding unread emojis|Finding unread emojis]] to find and fix any tasks with unread emoji values. + +### How can I check that a particular Task is formatted correctly? The Tasks plugin's ability to search tasks depends on the information in the tasks matching the plugin's parsing behaviour, described in the previous section. If not, tasks may be silently omitted from task searches. diff --git a/docs/Getting Started/Getting Started.md b/docs/Getting Started/Getting Started.md index 9630c2caa0..6e1f065417 100644 --- a/docs/Getting Started/Getting Started.md +++ b/docs/Getting Started/Getting Started.md @@ -231,7 +231,10 @@ This means that you can only put **block links** (`^link-name`) and **tags** aft We are tracking this in [issue #1505](https://github.com/obsidian-tasks-group/obsidian-tasks/issues/1505). -If you are concerned that some values in a task are not being parsed as you intended, perhaps because a task is not being found by Tasks searches, you can view the task in the [[Create or edit Task|‘Create or edit Task’ Modal]]. +If you are concerned that some values in a task are not being parsed as you intended, perhaps because a task is not being found by Tasks searches, you can: + +- view an individual task in the [[Create or edit Task|‘Create or edit Task’ Modal]] +- search for all possible problems: see [[Find tasks with invalid data#Finding unread emojis|Finding unread emojis]]. If there are any **Tasks emojis visible in the Description field**, close the modal and delete or move to the left any unrecognised text. diff --git a/docs/Reference/Task Formats/About Task Formats.md b/docs/Reference/Task Formats/About Task Formats.md index f119789c22..534bca2a54 100644 --- a/docs/Reference/Task Formats/About Task Formats.md +++ b/docs/Reference/Task Formats/About Task Formats.md @@ -74,6 +74,7 @@ In this early support for multiple formats, the following facilities don't (yet) - The order of fields on the task line still matters. - See [[Auto-Suggest#What do I need to know about the order of items in a task?]] - We are tracking this in [issue #1505](https://github.com/obsidian-tasks-group/obsidian-tasks/issues/1505). + - See [[Find tasks with invalid data#Finding unread emojis|Finding unread emojis]] to find and fix any tasks with unread emoji values. - Currently, Tasks only supports one format at a time (as mentioned above). - If you select the Dataview format, it will no longer read or write Tasks emoji signifiers. - We are tracking this in [issue #1891](https://github.com/obsidian-tasks-group/obsidian-tasks/issues/1891).