[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
descrption
instead 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.