Update todos

Author: adamziel

components/Blueprints/RunnerConfiguration.php

@@ -1,6 +1,6 @@
 <?php
 /**
- * @TODO add a configurable sqlite-database-integration data ref to the
+ * @TODO [_spec_]: add a configurable sqlite-database-integration data ref to the
  *       runner configuration in the markdown spec */
 
 namespace WordPress\Blueprints;

components/Blueprints/Steps/RunPHPStep.php

@@ -7,7 +7,7 @@
 
 /**
  * Represents the 'runPHP' step.
- * @TODO: Remove most step options from the specification. They don't apply to running PHP code,
+ * @TODO [_spec_]: Remove most step options from the specification. They don't apply to running PHP code,
  *        just to running HTTP requests. HTTP requests are not supported in this step.
  */
 class RunPHPStep implements StepInterface {

try-blueprints.php

@@ -4,13 +4,15 @@
  * @TODO: A large test suite.
  * @TODO: Client HTTP queue deadlock when we enqueued a lot of requests and need to fetch a small
  *        ad-hoc resource such as a JSON list of translations.
- * @TODO: Exception structure?
  * @TODO: Blueprint JSON validation.
  * @TODO: Support Zip Files without the Content-Length header.
- * @TODO: Add importMedia step to the specification.
- * @TODO: How to handle the default WordPress theme? Should it be preserved for new sites?
+ * @TODO [_spec_]: Add importMedia step to the specification.
+ * @TODO [_spec_]: How to handle the default WordPress theme? Should it be preserved for new sites?
  *        What if we want to remove it? And what should be the semantics for existing sites?
- * @TODO: Production-grade HTTP Cache support for remote files. Not the stopgap we have now.
+ * @TODO (low priority): Production-grade HTTP Cache support for remote files. Not the stopgap we have now.
+ *                       We can ship Blueprints without http cache support, but do not ship the stopgap solution 
+ *                       in production.
+ * @TODO (low priority): Exception structure?
  * @TODO (low priority): Restrictions on supported step types, media files types, SQL queries types, etc.
  * @TODO (low priority): Fast unzipping of remote Zip Files by iterating over the entries
  *        instead of skipping over to the end central directory index entry.