### Author:  [@dnolen](https://clojureverse.org/u/dnolen)
#### Post date: [March 4, 2018, 4:03pm UTC](https://clojureverse.org/t/clojurescript-1-10-x-new-quick-start-feedback-please/1679/1 "2018-03-04T16:03:41Z")
The next major release of ClojureScript is looming - it’s pretty massive 🙂 But probably the thing we’re most looking forward to is how much easier it is to use!
We’re rewriting the Quick Start from the ground up to highlight this:
>
Please give it a try! We cut a pre-release (1.10.126) just for it. The Quick Start is how new users will build their first impressions so we’re _very_ interested in making this as compelling as possible.
Looking forward to hearing your thoughts.
---
### Author:  [@vvvvalvalval](https://clojureverse.org/u/vvvvalvalval)
#### Post date: [March 4, 2018, 4:57pm UTC](https://clojureverse.org/t/clojurescript-1-10-x-new-quick-start-feedback-please/1679/2 "2018-03-04T16:57:17Z")
@dnolen this a great!
Typo spotted:
> Your default web browser will open to a page that looks like the following:
the image is missing.
---
### Author:  [@dnolen](https://clojureverse.org/u/dnolen)
#### Post date: [March 4, 2018, 5:01pm UTC](https://clojureverse.org/t/clojurescript-1-10-x-new-quick-start-feedback-please/1679/3 "2018-03-04T17:01:30Z")
Yeah there’s actually a few images I have in mind, but those will come later. At the moment I’m most interested in feedback about the overall impression of the guide.
---
### Author:  [@vvvvalvalval](https://clojureverse.org/u/vvvvalvalval)
#### Post date: [March 4, 2018, 5:40pm UTC](https://clojureverse.org/t/clojurescript-1-10-x-new-quick-start-feedback-please/1679/4 "2018-03-04T17:40:38Z")
@dnolen Ah right sorry.
Here’s some feedback regarding the content (keep in mind that I’m not a ClojureScript beginner, and that I don’t know precisely what the intended audience and goals of the guide are):
I notice that the overall setup is hugely reduced compared to previous versions, which is a very good thing as it should make ClojureScript much more accessible to beginners. In a similar vein, I also really appreciate that you can get both a REPL and a browser in the very first steps.
I would add an introduction sentence stating the scope of the guide, maybe something like: “In this tutorial, we will guide you through a basic setup for running ClojureScript programs interactively on your machine”. (Or maybe something else, maybe I got the scope wrong).
I would add a short introduction to the ‘ClojureScript compiler’ section, and maybe find another title - as it is, it is a bit hard to know where we’re getting at. Maybe something like: “in this section, we will see how to run a ClojureScript program in a web page and interact with it at the REPL.”
I would maybe also strive to reduce the amount of technological prerequisites: currently, the guide seems to assume that the reader knows about terminal windows, JavaScript, compilers, NodeJs, and most importantly, implicit knowledge about what ClojureScript does. This is not a new issue of course, but now that the setup is so massively simplified, addressing it seems within reach: maybe a few additions here and there to explain what’s going on in a more vulgarised form?
And again, congratulations and **THANK YOU** for this new release: the fact that I consider the above issues the most important ones is a telling sign of progress.
---
### Author:  [@jdeisenberg](https://clojureverse.org/u/jdeisenberg)
#### Post date: [March 4, 2018, 6:03pm UTC](https://clojureverse.org/t/clojurescript-1-10-x-new-quick-start-feedback-please/1679/5 "2018-03-04T18:03:40Z")
General comments: I would use the long options in the command `clj -m cljs.main -c hello-world.core -r` (`--main` instead of `-m`, etc.) because they aren’t as mysterious. The paragraph that explains the long commands then becomes “if you don’t like to type, here are the short forms of the options”
Instead of creating a function named `foo` that duplicates an operation already built in to the language, create a function with a more meaningful name `average` that is nominally useful but not overly complex:
```auto
(defn average [a b]
(/ (+ a b) 2.0))
```
I wasn’t able to go further, as after the reload, I got an error with `foo`:
```auto
TypeError: hello_world.core.foo is undefined
```
and evaluation of `(ffirst [1])` did not give me a stack trace, but a simple error: `Error: 1 is not ISeqable`
---
### Author:  [@dnolen](https://clojureverse.org/u/dnolen)
#### Post date: [March 4, 2018, 6:03pm UTC](https://clojureverse.org/t/clojurescript-1-10-x-new-quick-start-feedback-please/1679/6 "2018-03-04T18:03:59Z")
That’s all great feedback and I’ll definitely incorporate this into the next version.
---
### Author:  [@jmbroad](https://clojureverse.org/u/jmbroad)
#### Post date: [March 4, 2018, 6:38pm UTC](https://clojureverse.org/t/clojurescript-1-10-x-new-quick-start-feedback-please/1679/7 "2018-03-04T18:38:25Z")
Followed the steps exactly (on 1.9) After defining `foo` and reloading (`(require '[hello-world.core :as hello] :reload)`), the call to it failed:
```
cljs.user=> (hello/foo 2 3)
TypeError: Cannot read property 'call' of undefined
(NO_SOURCE_FILE)
```
It worked after I shut down the repl and restarted it.
Thanks,
Jonathan
---
### Author:  [@sambev](https://clojureverse.org/u/sambev)
#### Post date: [March 4, 2018, 6:39pm UTC](https://clojureverse.org/t/clojurescript-1-10-x-new-quick-start-feedback-please/1679/8 "2018-03-04T18:39:06Z")
I had the same problem with the `(ffirst [1])`
```auto
Compiling client js ...
Serving HTTP on localhost port 9000
Listening for browser REPL connect ...
Hello world!
To quit, type: :cljs/quit
cljs.user=> (require '[hello-world.core :as hello] :reload)
cljs.user=> (hello/foo 2 3)
5
cljs.user=> (inc 1)
2
cljs.user=> (ffirst [1])
Error: 1 is not ISeqable
```
I tried entering that in the repl first, not sure I was supposed to do that. I
also tried to add it to my hello-world/core.cljs file but with no luck:
```auto
(ns hello-world.core)
(println "Hello world!")
(defn foo [a b]
(+ a b))
(ffirst [1])
```
Result:
```auto
cljs.user=> (require '[hello-world.core :as hello] :reload)
java.net.SocketException: Broken pipe (Write failed)
at java.net.SocketOutputStream.socketWrite0(Native Method)
...
```
I also tried to add it to my `foo` function and had the same error as the repl:
```auto
(ns hello-world.core)
(println "Hello world!")
(defn foo [a b]
(ffirst [1])
(+ a b))
```
```auto
Serving HTTP on localhost port 9000
Listening for browser REPL connect ...
To quit, type: :cljs/quit
cljs.user=> (require '[hello-world.core :as hello] :reload)
cljs.user=> (hello/foo 3 2)
Error: 1 is not ISeqable
cljs.user=>
```
I went through the rest of the tutorial and everything else worked. Overall, this Quick Start is a lot better and simpler than the last one. Well done!
---
### Author:  [@ivanreese](https://clojureverse.org/u/ivanreese)
#### Post date: [March 4, 2018, 7:12pm UTC](https://clojureverse.org/t/clojurescript-1-10-x-new-quick-start-feedback-please/1679/10 "2018-03-04T19:12:48Z")
When starting the guide, I’m eager to get to the CLJS goodness. But first, I have to go through a bunch of tedious folder setup — one step at a time, with intermingled instructions for POSIX folks and Win folks.
If I were writing this guide, I’d replace most of the opening section with something like the following:
> First, set up a project folder for our Hello World project. Here’s a list of the files and folders you’ll need. Note that the underscores in the names are important.
>
> ```auto
> hello_world # Our project folder
> ├─ src # The CLJS source code for our project
> │ └─ hello_world # Our hello_world namespace folder
> │ └─ core.cljs # Our main file
> ├─ cljs.jar # (Windows only) The standalone Jar you downloaded earlier
> └─ deps.edn # (Mac/Linux only) A file for listing our dependencies
>
> ```
>
> Mac/Linux users, place the following in `deps.edn`:
>
> ```auto
> {:deps {org.clojure/clojurescript {:mvn/version "1.10.126"}}}
>
> ```
This change will also partly address @vvvvalvalval’s concern about “technological prerequisites” by cutting down on the amount of terminal futzing right off the start. Folks who want to live in the terminal will know how to make folders. Folks who are comfortable copy-pasting commands, but might be intimidated by…
```auto
md src\hello_world & type nul >>core.cljs & move core.cljs src\hello_world
```
…can comfortably get started in the Finder/Explorer.
Thanks for all your hard work on this, David!
---
### Author:  [@dnolen](https://clojureverse.org/u/dnolen)
#### Post date: [March 4, 2018, 8:31pm UTC](https://clojureverse.org/t/clojurescript-1-10-x-new-quick-start-feedback-please/1679/11 "2018-03-04T20:31:50Z")
Great suggestion. Need to see if I can do that in AsciiDoc.
---
### Author:  [@dnolen](https://clojureverse.org/u/dnolen)
#### Post date: [March 4, 2018, 9:15pm UTC](https://clojureverse.org/t/clojurescript-1-10-x-new-quick-start-feedback-please/1679/12 "2018-03-04T21:15:37Z")
I’ve updated the guide to reflect these specific suggestions.
---
### Author:  [@SpaceGuy](https://clojureverse.org/u/SpaceGuy)
#### Post date: [March 4, 2018, 9:21pm UTC](https://clojureverse.org/t/clojurescript-1-10-x-new-quick-start-feedback-please/1679/13 "2018-03-04T21:21:30Z")
With the Windows instructions, I get `Unrecognized option: -m`. Instead, `java -cp "cljs.jar;src" cljs.main -c hello-world.core -r` works.
When running that command for the first time without an existing “out” directory, the browser opens but “Hello World” doesn’t actually show up.
- `Loading failed for the