Kaynağa Gözat

More notes.

Brit Butler 11 yıl önce
ebeveyn
işleme
c2920901fa
1 değiştirilmiş dosya ile 9 ekleme ve 1 silme
  1. 9 1
      docs/hacking.md

+ 9 - 1
docs/hacking.md

@@ -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