32 ms·
The link near the top to "command line tools" (https://clojure.org/guides/deps_and_cli https://clojure.org/guides/deps_and_cli) is probably the next logical ste
by puredanger 8y ago
The link near the top to "command line tools" (https://clojure.org/guides/deps_and_cli https://clojure.org/guides/deps_and_cli) is probably the next logical step but maybe could be highlighted better. If you want to leave some comments on an issue at https://github.com/clojure/clojure-site/issues https://github.com/clojure/clojure-site/issues - that's a great place for me to take actionable feedback.
Fully learning the language, the tools, and how to make a project are all different topics, and have their own interactions with whatever other tooling they are using. I think a lot of that is there but I'll take your point that they aren't guided well enough. Definitely worth taking a few more passes, thanks.
- dmitriid 8y ago> probably the next logical step but maybe could be highlighted better It's definitely not a "next logical step". A next logical step is "create, test, and deploy a clojure program". For some reason these important topics are given a total of maybe 5 paragraphs inside a section on CLI tools? > I think a lot of that is there but I'll take your point that they aren't guided well enough "A lot is there" is a total of two paragraphs on writing a program outside of REPL, a total of two paragraphs not even on testing but on how to include a test directory. And that's it. As a beginner I wouldn't even know where to look for this (Google is often not enough). Clojurescript is slightly better in this regard. At least after the quick start guide I have some understanding on what goes there. I may open an issue if I don't forget tomorrow :D
- puredanger 8y agoI appreciate the feedback.
- dmitriid 8y agoIt took me a while to remember my promise :) https://github.com/clojure/clojure-site/issues/356 https://github.com/clojure/clojure-site/issues/356