Michael, this is great feedback.
> This tutorial is missing the crucial first step: explaining how to
> add Friend as a dependency with Leiningen
> (and Maven).
So, part of me had thought that these details would covered by looking
through the source of the repo, but on consideration, I think you're
right--this is indeed the kind of stuff I was bit by when I started
working with Clojure. Point taken; I'll tweak it to make that part clear.
> features Friend has: not everybody
> is coming from the same background and knows what Devise and CanCan
> are or what they are used for.
Good point--I'll add some links and/or descriptions, as it seems
appropriate.
> I haven't done Web development in a while so maybe it's just me but I
> have no idea what the "interactive form workflow"
> is.
Another good point: this is what it is called in Friend. I'll fix this
so it is more clear what I mean by this (or just change the wording).
> This one is missing the information about what port the example is
> running on. It's running now, cool,
> how do I try it out?
You should just be able to clone the repo, and start it up, assuming
you've got the necessary oauth config for FB or App.net. The source
should make it pretty clear, but if anything is unclear, do let me know.
Obviously the README is not enough, so if you play with it and have
ideas how it can be improved, let me know.
And sorry, what do you mean by "what port?"
> It will take a few rounds to make your tutorial good, don't get
> discouraged by it.
Not at all! This kind of feedback is exactly what I want. I want to
help make these docs as high quality as possible, so they can be a
resource for those coming into the community.
I have an ulterior motive: the more folks that are using Clojure for
building high-quality web apps, the more chance I can get a job doing
Clojure stuff fulltime, instead of as a hobby...haha.
Anyways, I'll update this stuff as soon as I have time. Thanks again
for the feedback, Michael.
DD
(12/10/07 2:01), Michael Klishin wrote:
2012/10/6 Dave Della Costa <ddellaco...@gmail.com
<mailto:ddellaco...@gmail.com>>
I've written some material on how to use Friend, including some OAuth2
resources. I'd appreciate any feedback you can give, I'm pretty new to
Clojure (and Lisp in general).
In any case:
https://github.com/ddellacosta/friend-interactive-form-tutorial
This tutorial is missing the crucial first step: explaining how to add
Friend as a dependency with Leiningen
(and Maven). Another thing worth adding is a section of what kind of
features Friend has: not everybody
is coming from the same background and knows what Devise and CanCan are
or what they are used
for.
I haven't done Web development in a while so maybe it's just me but I
have no idea what the "interactive form workflow"
is.
https://github.com/ddellacosta/friend-oauth2-examples
This one is missing the information about what port the example is
running on. It's running now, cool,
how do I try it out?
I have a bunch of other Clojure-related stuff on my github account too,
feedback is most welcome!
It's great to see someone writing tutorials for projects that are
fundamental building blocks (if you choose to
build a Web app in Clojure, you probably gonna need Friend or something
like Friend fairly quickly).
It will take a few rounds to make your tutorial good, don't get
discouraged by it.
And I really hope it will make it into Friend's documentation in some
shape or form.
--
MK
--
You received this message because you are subscribed to the Google
Groups "Clojure" group.
To post to this group, send email to clojure@googlegroups.com
Note that posts from new members are moderated - please be patient with
your first post.
To unsubscribe from this group, send email to
clojure+unsubscr...@googlegroups.com
For more options, visit this group at
http://groups.google.com/group/clojure?hl=en
--
You received this message because you are subscribed to the Google
Groups "Clojure" group.
To post to this group, send email to clojure@googlegroups.com
Note that posts from new members are moderated - please be patient with your
first post.
To unsubscribe from this group, send email to
clojure+unsubscr...@googlegroups.com
For more options, visit this group at
http://groups.google.com/group/clojure?hl=en
