Update Deck Options

[brishtibheja]

There are links to very old forum posts, mostly outdated, what do we do about them?

[Danika-Dakika]

links to very old forum posts

Which ones specifically?

---

Also: Is this PR still a work in progress, or are you submitting it for review now?
Are you incorporating new language to fix this as well? Or does it still need to go into the issue tracker?

[brishtibheja]

Which ones specifically?

• Deck Options Explained
• Deck Options in a Mental Map

Is this PR still a work in progress, or are you submitting it for review now?

Draft means I'm still working on it. You can still add comments though.

Are you incorporating new language to fix this as well?

I already fixed this. So no need for issue tracker.

[Danika-Dakika]

Draft means I'm still working on it. You can still add comments though.

That's why I asked -- because that's exactly what I'm trying to avoid. Reviewing incomplete PRs is a waste of time. If there's something significant and specific you need to consult on before your PR is final -- a draft PR might make sense. Is the question you asked about the links the only thing outstanding, and otherwise your work is done?

[brishtibheja]

Is the question you asked about the links the only thing outstanding, and otherwise your work is done?

I'm still going through everything. It's not done yet. The draft allows other people to know what I'm doing and optionally comment on it if they want. Expertium will want to see what I do in FSRS section.

[brishtibheja]

Anybody knows what is this cross-referencing? I didn't find anything.

[Danika-Dakika]

Isn't this on point? Replay is controlled with that Deck Options setting -- initial-play is controlled on the template.

FrontSide will not automatically play any audio that was on the front side of the card. If you wish to have the same audio play automatically on both the front and back of the card, you’ll need to manually include the audio fields on the back as well.

[brishtibheja]

I was thrown into some unfamiliar section; didn't even noticed that line. I changed this to:

Controls whether audio from the question side is played when you use replay action on the answer side. Note that, Anki does not automatically play audio from the {{FrontSide}} field. This option does not influence the behaviour of automatic play.

[Danika-Dakika]

I'm still going through everything. It's not done yet.

Got it. 👍🏽 I'll wait until you submit it for review.

[Expertium]

@brishtibheja the link to the graph seems to be broken

[bqv]

My vote is to stick with "scheduler", for what it matters

[Expertium]

You mean "SM-2 scheduler" and "FSRS scheduler"?

[Danika-Dakika]

Danika: idk, they haven't commented yet

@Expertium I did, I did!
I'm rock solid on drawing the distinction between algorithm and scheduler. FSRS is an algorithm, v3 is a scheduler.

Last month on your Reddit thread:

They are just 2 completely different things. Before FSRS, folks often only spoke in terms of the "scheduler" -- because all versions of the scheduler were using the SM-2 algorithm. But when talking about SM-2, the word "algorithm" has regularly been used, with no confusion.

Now we are just being more transparent about what things are the job of the scheduler and what are the job of the algorithm. I don't think this is actually confusing to people.

[Danika-Dakika]

Can we do further bikeshedding in a different PR?

@brishtibheja It's pretty dismissive to refer to others editing your copy as "bikeshedding" -- or perhaps you and I don't have the same understanding of that term. But, I think that Damien's point is probably a better place to put our focus -- #250 (comment) . This PR is probably just too big.

In the future, even if an entire page needs an update, "do one thing" is still the best guideline to follow.

[brishtibheja]

It came up some time ago in discord, but I keep using that word wrong. I agree with you and dae. This was too huge. I think this is in a mergeable form now, so I'll follow up with another PR with formatting changes, etc.

@dae is there anything left to do here? Think it should be good to go now.

[Expertium]

1. Will the workload-retention graph be updated once the PR is merged?
2. I recommend waiting for Create frequently-asked-questions-about-fsrs.md faqs#36 to be merged. Then I can add a link to FAQ here. Frankly, I really dislike that the manual and FAQ are two different things, it just cripples discoverability for no reason, since users have to discover the manual and the FAQ separately.
   Anyway, I think linking to FAQ at the end of the FSRS section is reasonable.

[brishtibheja]

1. The graph is already updated. I only needed to delete the previous file and upload the new one with the same name. It's showing the new image in website now.
2. I'll do a second PR anyway. Also, we link people to the FAQ from the FAQ section of the manual. Yeah, there's a section for that.

[Expertium]

Also, we link people to the FAQ from the FAQ section of the manual.

Yeah, but unless Dae is fervently against linking to FAQ from Deck Options, I'd like to do so. Same reasoning - improving discoverability, so that users have an easier time finding all the relevant links and info.

[Expertium]

https://faqs.ankiweb.net/frequently-asked-questions-about-fsrs.html

@brishtibheja please add this to deck options. Something like "Several frequently asked questions about FSRS have been answered here"

[dae]

Thanks for all the hard work that went into this.

No objections to linking to the FAQ. Can't remember if I mentioned it elsewhere already, but I actually think we might be better off consolidating all info into the manual in the long run - the separate FAQ page was mainly a convenience for support in the past.

[dae]

(I won't hold up the PR with that change as it's been waiting long enough; follow-up welcome)