documentation: improve the explanation about backtick templates #9281
Labels
Area/BBE
Issues related to BBEs.
Kind/Language
Type/Improvement
Improvements required on the website.
Milestone
Description:
As a new learner of Ballerina, good documentation is really critical. I think the docs and examples are great, but there are some rough areas and minor typos (I'll probably report these also in another ticket).
The topic is about backtick templates.
Describe your problem(s)
Those are documented but I think it's not presented in an intelligible fashion, or the ordering is out of sequence.
Please see this discord thread for background.
Describe your solution(s)
A better introduction about those is needed (along the lines of this). Currently the first article in the section starts with "A raw template is a backtick template without a tag. Exposes result of phase 1 without further processing" but doesn't define what a 'tag' is, nor 'phase 1' - that terminology is a little strange and is not explained upfront (a diagram to point out where the tag is in the code might be helpful). The concept of phase 1 & 2 is introduced in the 2nd article. Those pages should get a revamp for clarity.
Suggested Labels (optional):
documentation
Thanks to Sasindu Alahakoon for his assistance.
The text was updated successfully, but these errors were encountered: