Tweak docs

[MariusVolkhart]

Fix some Kotlin code, correct an indent level, and provide some more info on how model code generation replaces precompiled templates.

[casid]

Welcome @MariusVolkhart and thanks for your contributions!

IMHO this note is a bit misleading:
This replaces the process of [precompiling templates](pre-compiling.md).

jte-models generates an additional facade so that templates can be called through that facade. But behind the scenes it either calls the templates dynamically and compiles them on demand (good for development, bad for production), or it calls the previously generated/precompiled template methods (bad for development, good for production).

[MariusVolkhart]

Fair point! I was trying to convey that when using the generate stage at build time, you can't also use the pre-compile stage. I found myself spending a fair bit of time trying to wrap my head around the relationship/tradeoff between binary encoding, precompile on-disk, precompile in classpath, and generated models. I'll work on the wording for this.

[marcospereira]

Good catch!

I'm actually trying to find the time to externalize the code samples in .java/.kt files that are compiled. It is supported by MkDocs, and it would be easier to maintain. We can also externalize the template examples.

[MariusVolkhart]

@casid I took another stab at this, this time linking more liberally between the strategies (binary encoding, pre-compiled, and facade). I would appreciate you giving this another look and any feedback you might have.

[casid]

Looks good, thank you so much!