You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Attempting to fix a dead link on the Stylesheets README (see #703 and #710) leads to an unhappy discovery: Our documentation about working locally with the Stylesheets is outdated.
I recommend that we rewrite the Using the TEI GitHub Repository page that now only exists on the old TEI website. Some of the information is useful, but much of it is out of date.
We should definitely remove the outdated info about working with the old Roma.
Maybe we can trim this to confine the advice to local installation requirements and how to work with the Makefile?
If we make a new version of this page, we should link it to our TCW 32: Testing and Building the TEI Guidelines, which provides guidance on the Docker environment.
The text was updated successfully, but these errors were encountered:
It strikes me that we may have more than one distinct audience for this documentation. There are Council people, who can be expected to be more tech-savvy and who will have guidance and mentoring from existing members; they will need to run and debug stylesheets tests as well as just using the stylesheets. Then there are end-users, who are presumably either interested in doing more that is possible through TEI-Garage or perhaps need to work without regular access to it, and they'll need more user-friendly guidance but won't need to worry about the tests. There's also a distinction between documentation of how the stylesheets actually work (for maintainers) and documentation of how to use them. Should we be creating separate resources for these audiences and purposes?
Attempting to fix a dead link on the Stylesheets README (see #703 and #710) leads to an unhappy discovery: Our documentation about working locally with the Stylesheets is outdated.
I recommend that we rewrite the Using the TEI GitHub Repository page that now only exists on the old TEI website. Some of the information is useful, but much of it is out of date.
The text was updated successfully, but these errors were encountered: