- From: Timothy Cole <t-cole3@illinois.edu>
- Date: Thu, 1 Sep 2016 09:56:43 -0500
- To: Shane McCarron <shane@spec-ops.io>, "'W3C Public Annotation List'" <public-annotation@w3.org>
- Message-ID: <04ce01d20461$11ae7370$350b5a50$@illinois.edu>
Shane- New data model tests (i.e., checking body and target constraints) are have been added to the annotation-level tests already available on the testdev server. These are ready to be migrated up to production, but as mentioned last night we need to get rid of old, deprecated tests and json files. I also have some feedback on the test script UI that would be nice to address if not too difficult (see below). Where we are with the data model tests: Mandatory tests - all annotations should pass all assertions checked by these 3 tests: 1. Annotation-level: http://testdev.spec-ops.io:8000/annotation-model/annotations/annotationMusts -manual.html (14 assertions) 2. Body-level: http://testdev.spec-ops.io:8000/annotation-model/bodiesTargets/bodyMusts-man ual.html (16 assertions) 3. Target-level: http://testdev.spec-ops.io:8000/annotation-model/bodiesTargets/targetMusts-m anual.html (15 assertions) Recommended / Optional tests - most individual annotations will "fail" a majority of these assertions: 1. Annotation-level: http://testdev.spec-ops.io:8000/annotation-model/annotations/annotationOptio nals-manual.html (15 assertions) 2. Annotation-level Agents: http://testdev.spec-ops.io:8000/annotation-model/annotations/annotationAgent Optionals-manual.html (16 assertions) 3. Body-level: http://testdev.spec-ops.io:8000/annotation-model/bodiesTargets/bodyOptionals -manual.html (28 Assertions) 4. Target-level: http://testdev.spec-ops.io:8000/annotation-model/bodiesTargets/targetOptiona ls-manual.html (25 assertions) 5. Body and Target-level Agents: http://testdev.spec-ops.io:8000/annotation-model/bodiesTargets/bodyTargAgent Optionals-manual.html (16 assertions) Suggestions: A. The text box for inputting JSON-LD annotation and the Check JSON button need to appear on the form before the list of assertions being checked. The list of assertions is of variable length and can be quite long. Better when you have to paste in your annotation 8 times that the input box be higher on the form and always in the same spot. B. Per discussion, the title of each assertion contains mark-down. This shows up formatted on the input form, but in the summary of results, the mark-down is not being processed. Any way to fix? C. When a test 'fails' the error message from the assertion is displayed first (good), but then the AJV error message and test script trace is concatenated, not useful for the person submitting the annotations for testing. Is there any way to suppress (e.g., in hidden HTML) the AJV and test harness trace error messages, or to format to be less prominent? D. Most annotations will fail most recommended / optional assertions. These are intended to identify what features have been implemented in any given annotation and do not really go to validation per se, and relatively few individual annotations implemented more than a handful of optional features. Example 44 from our model only pass 3 out of 25 target 'tests'. Is there any option on should and may assertions to tone down the red small caps FAIL error message? Something in yellow and maybe a different word than FAIL? Alternatively, we may need to discuss granularity further - separate post forthcoming. Any changes to help ameliorate any of these issues that are easy to fix before moving latest into production would be appreciated. Thanks, Tim Cole
Received on Thursday, 1 September 2016 14:57:31 UTC