My Task Dependencies are working inverse from the documentation (error in documentation) about obsidian-tasks HOT 4 CLOSED

Thanks for the kind words.

I do understand the confusion.

FYI, here's what has been tried so far:

My original preference was to label the fields Before this task and After this task but there was not enough space.

As a result, we put this text in the placeholder/hint:

I also tried with just Before and After - and it was 100% ambiguous as to which way round it meant...

from obsidian-tasks.

Hi @DaveHenning,

tl;dr although the pics are right in the documentation, two key bits of wording in the documentation were the wrong way round.

Sorry for the inconvenience - and thank you for reporting it.

Explaining the search difference

It took me a while to figure out what is going on - I needed to put the screenshots side-by-side - you might need to click on the image to see it full-size:

The images in the right hand side show a dependency that is the opposite way round to the docs on the left hand side - so the search is correct, your "Build a first draft" task is really blocked by the "Test with users" task.

Checking the documentation

The pictures in the documentation are correct.

However, on closer inspection, I believe the wording in the documentation is wrong.

I think that the two phrases in yellow here are the wrong way round and should be swapped?

from obsidian-tasks.

I've fixed the wording in the docs, and improved the formatting to make the differences clearer to see.

It is published:

from obsidian-tasks.

First, thank you for always being so quick to respond.

After giving it some more thought, I've realized that my confusion stemmed from the use of the word "this." Initially, I interpreted "this" as referring to the task I was selecting in the before/after fields. For example, I understood 'Build a first draft' to be completed before the task 'Test with Users.'

However, I now understand that "this" actually refers to the task currently being edited. So, it should be interpreted as: complete 'Build a first draft,' and then, after this task is done, proceed to 'Test with Users.' In this light, entering 'Test with Users' in the After this field makes sense.

Reaching this understanding took a bit of time, and I apologize for the detailed explanation. I had to draft this message to clarify it for myself. I wasn't going to share it, but I decided to do so, thinking it might help others who could interpret it similarly. Also, I recognize the challenge in making this clearer without inadvertently increasing confusion. One idea; removing "this" - seems to make it less clear (actually, aligning more with my initial misunderstanding). Any additional alternatives I've considered might either contribute to the confusion or complicate the user interface. Your current implementation seems to be the most effective approach.

Thank you for all you do. Tasks is my favorite plugin for Obsidian.

from obsidian-tasks.