docs: Update v2 caching docs

[Levdbas]

Related:

• [BUG] symfony/cache-extra and timber 2, cache method unclear #2762
• [Docs] Improve Performance/Caching docs #2441
• Minify html output  #2038

Issue

The caching docs needs some TLC. In this PR I will try to tackle these three tickets at once.

Solution

Better documentation!

Impact

Better understanding of caching in Timber.

Usage Changes

None.

Considerations

None.

Testing

No.

[coveralls]

coverage: 88.525%. remained the same when pulling 96fc0a0 on v2-caching-docs-update into 5149aa7 on 2.x.

[gchtr]

I see that you’re still working in this, but thanks a lot for taking this on!

[Levdbas]

Finally took the time to finish the last part and tried to order the guide in a way that makes sense.

[gchtr]

Thanks a lot @Levdbas. These updates surely help to understand what’s going on.

I want to take some more time to polish the performance docs. There are some sections in there that could just be deleted, like the TLDR; section and I saw some other details I want to improve.

I’m moving this to 2.x Future.

[Levdbas]

Should we just merge this for now @gchtr ? The change about the change at twig/cache-extra is then at least documented when people are going to migrate to 2.0. Let me know what you think.

[gchtr]

Should we just merge this for now @gchtr ? The change about the change at twig/cache-extra is then at least documented when people are going to migrate to 2.0. Let me know what you think.

Yeah, maybe that’s better. I created an issue in #2830 and I’m merging this.