Differences

This shows you the differences between two versions of the page.

--- tools:bikeshed [2014/01/27 22:34] – created tantek
+++ tools:bikeshed [2014/01/27 23:23] – add Troubleshooting section with a couple of initial beginner errors tantek
@@ Line 7: / Line 7: @@
 See https://github.com/tabatkins/bikeshed#bikeshed-a-spec-preprocessor for more details.
+===== Troubleshooting =====
+==== blank page ====
+If you get a blank page from submitting the bikeshed webform, then
+  * go back to the Bikeshed web form - https://api.csswg.org/bikeshed/
+  * change the "Output" radio button to "Errors & Warnings"
+  * resubmit to get actual specific errors
+==== requires metadata ====
+If you get an error:
+<code>
+Error running preprocessor, returned code: 1.
+[1;31mFATAL ERROR:[0m The document requires at least one metadata block.
+</code>
+See https://github.com/tabatkins/bikeshed/blob/master/docs/metadata.md for how to create a metadata block for your spec.