Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Installation instructions for newbies #131

Closed
martimatix opened this issue May 21, 2020 · 4 comments
Closed

Installation instructions for newbies #131

martimatix opened this issue May 21, 2020 · 4 comments

Comments

@martimatix
Copy link

It'd be nice to add some installation instructions for newbies. Maybe it's common knowledge among Clojurists that to install a lein script, you need to add it to ~/.m2 but for those that don't, some research is required.

@mike-thompson-day8
Copy link
Contributor

@martimatix
Could you give a more concrete example, please? I'm not understanding what you mean by "installation instructions".

Do you mean something like this:
https://purelyfunctional.tv/guide/how-to-install-clojure/

@martimatix
Copy link
Author

Suppose you're brand new to the world of Clojure and Clojurescript. You've read about the new re-frame design on reddit. You start reading about re-frame and you're sold. "I want to get started," you think to yourself. You go to the Start Coding page and see that there's a template to scaffold your project (this repo).

You're on a Mac and have run brew install clojure but don't really know much about Clojure or Leiningen.

You click on the link to this repo and start reading the readme. You read that you need to run lein new re-frame <project-name> but how do you install it? That is to say, if I run git clone https://github.com/day8/re-frame-template.git in any old directory, Leiningen won't be able to find it.

For the sake of Clojurescript newbies, I was suggesting that something like this be added:

  1. clone this repo
  2. copy src/leiningen/new to ~/.m2/repository
    (by the way, is there an easier way?)

That was a long winded way of describing the situation that I found myself in. I ended up having to search for installing Leiningen templates and found this page.

Going through this experience prompted me to open this issue.

@martimatix
Copy link
Author

Never mind, turns out that you don't need to clone this repo at all. 🤦‍♂️

lein new re-frame <project-name> is all you need.

@mike-thompson-day8
Copy link
Contributor

I'm glad you worked it out.

But you got me thinking, and I added this to the README https://github.com/day8/re-frame-template/blob/master/README.md#before-you-start.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

No branches or pull requests

2 participants