Hi Phillip,
Basically, "tck-testable" et al. (they are described at
https://github.com/beanvalidation/beanv ... or-the-tck) are labels/roles which can be applied to a given block of the AsciiDoc spec document.
Then we've got a custom AsciiDoctor extension (
https://github.com/beanvalidation/beanv ... or-the-tck) which allows to propagate those labels to the DocBook output (i.e. XML). Using an XSL transformation (see
https://github.com/beanvalidation/beanv ... audit-file), finally an XML document containing just the assertions is generated (the "audit file").
This audit file is used to create a coverage report against the tests in the TCK (see
http://docs.jboss.org/hibernate/stable/ ... age_report). Tests are linked to assertions from the audit file via the @SpecAssertion annotation. This report tells us how many spec assertions are covered by tests (it doesn't tell anything about the quality of those tests, though. Also an empty test would count, but we're thorough developers of course :).
So the current path is AsciiDoc -(AsciiDoctor)-> DocBook -(XSLT)-> Audit file. That's mainly due to historical reasons, the spec was written in DocBook originally and we already had that XSL transformation for extracting the assertions. So when we migrated from DocBook to AsciiDoc, this was the quickest approach.
A better path would of course be AsciiDoc -(AsciiDoctor)->Audit file, which I think would require a custom AsciiDoc output generator. We didn't find the time to do this, but should you decide to base your TCK on this tooling, it might be something for you to look into?
Happy to discuss any details in more depth. The best is you send any questions to the BV mailing list (
http://lists.jboss.org/pipermail/beanvalidation-dev/), I'll usually be quicker with replying there. We also can do a call or Hangout with you, Ivar and Christian if that'd help?
Cheers,
--Gunnar