|
@@ -227,7 +227,7 @@ coleslaw if there's a problem during a build is unpleasant
|
227
|
227
|
at best, especially for anyone not coming from the lisp world.
|
228
|
228
|
|
229
|
229
|
We need to start handling errors and reporting errors in ways
|
230
|
|
-that are useful to the user. The two most obvious areas seem to be:
|
|
230
|
+that are useful to the user. Example errors users have encountered:
|
231
|
231
|
|
232
|
232
|
1. Loading of Content. If `read-content` fails to parse a file, we
|
233
|
233
|
should tell the user what file failed and why.
|
|
@@ -235,6 +235,14 @@ that are useful to the user. The two most obvious areas seem to be:
|
235
|
235
|
do not currently error. They just wind up returning whitespace.
|
236
|
236
|
When the theme compiles, we should alert the user to any obvious
|
237
|
237
|
issues with it.
|
|
238
|
+3. Trying to load content from the bare repo instead of the clone.
|
|
239
|
+ i.e. Specifying the `:repo` in .coleslawrc as the bare repo.
|
|
240
|
+ The README should clarify this point and the need for posts to be
|
|
241
|
+ ".post" files.
|
|
242
|
+4. `:staging-dir`, `:repo`, `:deploy-dir` should all have trailing
|
|
243
|
+ slashes. This is a subtle, unenforced issue not mentioned in
|
|
244
|
+ documentation. This is exactly the sort of thing the next release
|
|
245
|
+ should strive to fix. (Also, `:repo` can probably be deprecated...)
|
238
|
246
|
|
239
|
247
|
### Scripting Conveniences/Basic Install
|
240
|
248
|
|