[TIMOB-7544] Tooling: validate.py should generate errors for unsupported YAML keys
| GitHub Issue | n/a |
|---|---|
| Type | New Feature |
| Priority | High |
| Status | Closed |
| Resolution | Fixed |
| Resolution Date | 2012-02-13T15:35:03.000+0000 |
| Affected Version/s | n/a |
| Fix Version/s | Sprint 2012-04, Release 2.0.0, Release 1.8.2 |
| Components | Tooling |
| Labels | n/a |
| Reporter | Arthur Evans |
| Assignee | Bill Dawson |
| Created | 2012-02-03T14:42:36.000+0000 |
| Updated | 2017-03-06T18:58:32.000+0000 |
Description
If we insert an invalid keyword in the YAML markup, it's silently ignored. This includes errors such as:
- misspelling "description" as "desciption"
- including fields that aren't defined in the TDoc spec, such as "note"
- leaving the s off the end of "platforms:"
All of these fail silently in both validate and docgen, so the information is omitted from the docs without warning.
Testing Notes: 1) Open any of our documentation .yml files and purposely mess up one of the key names (like
descrptioninstead ofdescription.) Or add a new key that is not [in the spec](https://wiki.appcelerator.org/display/guides/TDoc+Specification). Or do both for fun. 2) run validate.py. The messed up key(s) should be noted in the output.Pull request ready https://github.com/appcelerator/titanium_mobile/pull/1408
Closing ticket due to time passed.