obsidian-tasks icon indicating copy to clipboard operation
obsidian-tasks copied to clipboard

Document tips for getting best performance from Tasks plugin

Open claremacrae opened this issue 2 years ago • 14 comments

In working on #886 - and from discussions in #697 - I've learned some useful things that are worth sharing for users, for when Tasks' rendering of tasks is slowing down editing.

I would like to write them up before the next release, as a quick list.

claremacrae avatar Jul 14 '22 17:07 claremacrae

Deferring this until after 1.9.0 release.

claremacrae avatar Jul 17 '22 11:07 claremacrae

Bump - 1.9 was a couple of months ago now

bradmurray avatar Sep 23 '22 17:09 bradmurray

Thanks but bumps don't really help add to my available hours in the day!

However, @bradmurray, if I were to give you a long, raw list of bullet points, would you be interested in writing it up as a first attempt at this documentation? It would be a tremendous help.

claremacrae avatar Sep 23 '22 18:09 claremacrae

sure

bradmurray avatar Sep 24 '22 13:09 bradmurray

Great - thank you. I'm just looking through the file now.

claremacrae avatar Sep 24 '22 13:09 claremacrae

Hi @bradmurray, many thanks for agreeing to have a look at this.

The "data"

OK here is the document, heavily improved:

891 - Issue - document performance tips.md

The hardest thing to explain was the Live Preview issue, which I've now got a video repro for, which is in #1177.

Don't feel you need to include all of the content from that file. It was very developer-focused, and the more important thing is a user-focused version of it.

How the docs work

The CONTRIBUTING page has a section on maintaining the documentation, and it links to the docs/README.md which shows how to run the docs on your local machine.

Where to put the new file

I suggest putting it as a new page inside Advanced for now... I'll find a better location for it by the time it's published. (I'm thinking of a new 'Getting Help' section...)

Anything else...

Please don't hesitate to ask if anything doesn't make sense. And we could always have an audio or video call online if it would get you up to speed faster, or help in any way.

Thanks again!

claremacrae avatar Sep 24 '22 17:09 claremacrae

Hi @bradmurray - no pressure at all, but how are you feeling about this?

No pressure either way, if you would either like to have a look at it, or not have a look at it. Either is fine.

claremacrae avatar Nov 21 '22 21:11 claremacrae

Hey mates, do you know if is there any way to avoid the instant refresh when I'm editing a task?

Sometimes when I've multiple tabs and I try to update a small typo in a checklist, it's super slooooow to do.

It would be nice to turn-on/off the auto-refresh or have an option to update it after a few configurable minutes (let's say, 5 minutes), in the meanwhile, the queries would use the cache values, it would require an option to force the refresh of course.

There is a nice plugin called Jira Issue that does that.

image

Other option could be: update only when the cursor of the user leaves the task-line.

FabianoLothor avatar Feb 03 '23 14:02 FabianoLothor

We are not all guys.

claremacrae avatar Feb 03 '23 14:02 claremacrae

Sorry @claremacrae :facepalm: :sweat_smile:

Comment updated. :p

FabianoLothor avatar Feb 03 '23 14:02 FabianoLothor

Thank you. So the tips are in the document linked in comment https://github.com/obsidian-tasks-group/obsidian-tasks/issues/891#issuecomment-1257024257

the good news is that issue mentioned in #1177 has since been fixed in Obsidian.

claremacrae avatar Feb 03 '23 14:02 claremacrae

After reading the performance tips document you might want to include a note of something to absolutely not do. Create multiple documents that just query tasks all over the place, include them all in a single Canvas document and pin the Canvas 😁

elvarb avatar Feb 14 '23 11:02 elvarb

After reading the performance tips document you might want to include a note of something to absolutely not do. Create multiple documents that just query tasks all over the place, include them all in a single Canvas document and pin the Canvas 😁

😢 - sorry about that! Thank you very much indeed.

claremacrae avatar Feb 14 '23 11:02 claremacrae