I have added a comment on the doc two days ago. However, it needs further explanations:

I have looked to TEI council profiles; from what I understood, you have a lot of knowledge in encoding, more than a lot of digital practitioners who use TEI (and other encoding languages needed to work with TEI) mostly for their investigation in a text/corpus/artefact. This is my case: I use TEI and other languages because I need these tools for investigating my corpus. By saying this, I have not the same background/knowledge (and goal) than most of you. Thus, if you agree, my first remarks will rather be (at least for now) to make sure than beginners or digital practitioners (but no experts in programming languages) will be able to understand not only encoding but also how it can help them to improve their research. In addition, I think we need to take advantage of each opportunity for doing a little pedagogy and the Stylesheets released is a good opportunity.

When you did the release of the Guidelines http://www.tei-c.org/release/doc/tei-p5-doc/readme-3.1.0.html (thanks James), you tried to give a few helpful information—although we can always be improved.

As for this Stylesheets release, I think we need to give further information regarding the issues resolved--not for all topics since a few of them will not be as much interest for beginners or average level. For example, something like:

“Among other issues resolved in the last stylesheets v7.46.0 released:
- In order to avoid a schematron [link] processor (in other words rule-based validation language) error regarding @ageAtDeath [link], rather used teidata.count [link] attribute group instead of teidana.numeric [link] (https://github.com/TEIC/Stylesheets/issues/322)”--I don’t know if it was updated on TEI website, but if this is the case, also add the TEI link updated.

- …”

However, we need to ask ourselves the following question: how the issues resolved can be helpful to beginner and average level practitioners, in order to choose the issues which need more information.

Lastly, I’m not convince all readers will understand what is “stylesheets released.” —maybe under bracket something like “improvements according to issues resolved.”

I suggest that the message has two sections: one for experts and one for beginners and average levels practitioners.

Hope my explanation is clear enough… and that I’m not getting wrong in TEI council goals.

Best,

Vanessa