search

cryogen-project / cryogen

A simple static site generator written in Clojure
http://cryogenweb.org/
Eclipse Public License 1.0
1.09k stars 96 forks source link

Doc: "full build" is only mentioned in the end. #239

Closed jgomo3 closed 2 years ago

jgomo3 commented 3 years ago

Maybe the documentation doesn't mention lein run until the last article "Fast Compilation", where it says "make sure to make a full build (f.ex. via lein run) before publishing your site".

Maybe I missed it. The fact is that I was trying to find a command for only "building" the public folder, as I've been using the lein ring serve for that purpose; and I didn't find it until that last section.

It would be nice to find a place in the "deploying" or "publishing" sections where an explicit instruction to "build" is expressed.

And now that you are supporting both lein and Clojure CLI, that instruction should go for both.

yogthos commented 3 years ago

Good idea. I've documented doing a single build in the quick start section here.

holyjak commented 2 years ago

@yogthos can we close this one? If not, what remains to be done?

holyjak commented 2 years ago

This https://github.com/cryogen-project/cryogen/pull/242/commits/65b39b3785259adbf6e462e9a51143e243a6e04d is also making it clearer in the generated docs post, so I think that is sufficient.