ANN: Clojure Atlas (preview!)

43 views
Skip to first unread message

Chas Emerick

unread,
Apr 19, 2011, 12:19:32 PM4/19/11
to Clojure

Today, I’m opening up a “preview” site for Clojure Atlas [1], a new side project of mine that I’m particularly excited about.

Clojure Atlas is an experiment in visualizing a programming language and its standard library.  I’ve long been frustrated with the limitations of text in programming, and this is my attempt to do something about it.  From the site:

While Clojure Atlas has a number of raisons d’être, it fundamentally exists because I’ve consistently thought that typical programming language and API references – being, in general, walls of text and alphabetized links – are really poor at conveying the most important information: not the minutiae of function signatures and class hierarchies, but the stuff that’s “between the lines”, the context and interrelationships between such things that too often are only discovered and internalized by bumping into them in the course of programming. This is especially true if we’re learning a language and its libraries (really, a never-ending process given the march of progress), and what’s standing in our way is not, for example, being able to easily access the documentation or signature for a particular known function, but discovering the mere existence of a previously-unknown function that is perfect for our needs at a given moment.

This is just a preview – all sizzle and no steak, as it were.  I’m working away at the ontology that drives the visualization and user experience, but I want to get some more early (quiet) feedback from a few folks to make sure I’m not committing egregious sins in various ways before throwing open the doors to the world.

In the meantime, if you’re really interested, follow @ClojureAtlas [2], and/or sign up for email updates [3] on the site. 

- Chas



P.S. This is a ML repost of my announcement @ http://cemerick.com/2011/04/19/clojure-atlas-preview/

Ambrose Bonnaire-Sergeant

unread,
Apr 19, 2011, 12:27:23 PM4/19/11
to clo...@googlegroups.com
Oh wow, this looks exciting! Subbed.

Ambrose

--
You received this message because you are subscribed to the Google
Groups "Clojure" group.
To post to this group, send email to clo...@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+u...@googlegroups.com
For more options, visit this group at
http://groups.google.com/group/clojure?hl=en

Paul deGrandis

unread,
Apr 19, 2011, 12:45:16 PM4/19/11
to Clojure
This is a great piece visualization for Clojure and very much how I
think about the language as I'm working with it (based on the pictures
and descriptions). This is a nice niche piece of documentation for
the community, power users, and newly emerging Clojure shops.

Is your freemium model limiting namespaces/content. functionality, or
both?

Paul


On Apr 19, 9:27 am, Ambrose Bonnaire-Sergeant
<abonnaireserge...@gmail.com> wrote:
> Oh wow, this looks exciting! Subbed.
>
> Ambrose
>
> On Wed, Apr 20, 2011 at 12:19 AM, Chas Emerick <cemer...@snowtide.com>wrote:
>
>
>
>
>
>
>
> > Today, I’m opening up a “preview” site for Clojure Atlas [1], a new side
> > project of mine that I’m particularly excited about.
>
> > Clojure Atlas is an experiment in visualizing a programming language and
> > its standard library.  I’ve long been frustrated with the limitations of
> > text in programming, and this is my attempt to do something about it.  From
> > the site:
>
> > While Clojure Atlas has a number of *raisons d’être*, it fundamentally
> > exists because I’ve consistently thought that typical programming language
> > and API references – being, in general, walls of text and alphabetized links
> > – are really poor at conveying the most important information: not the
> > minutiae of function signatures and class hierarchies, but the stuff that’s
> > “between the lines”, the context and interrelationships between such things
> > that too often are only discovered and internalized by bumping into them in
> > the course of programming. This is especially true if we’re learning a
> > language and its libraries (really, a never-ending process given the march
> > of progress), and what’s standing in our way is not, for example, being able
> > to easily access the documentation or signature for a particular known
> > function, but *discovering* the mere existence of a previously-unknown

rob levy

unread,
Apr 19, 2011, 1:10:17 PM4/19/11
to clo...@googlegroups.com
This seems great.  The $20 bothers me, not because I don't want to pay it, I would gladly donate this meager amount for such a useful resource.  There's just something in poor taste about not making this open to everyone.  And there's an implicit camaraderie and good will that developer communities have come to expect that makes this paywall seem weird and unwelcoming.  If you framed this as a donation, with access not contingent on donation, it would be perfectly fine-- and people might actually use it.

Aaron Bedra

unread,
Apr 19, 2011, 1:23:06 PM4/19/11
to clo...@googlegroups.com
I would pay $20 per project for this easily.� You did some great work (from the looks of it anyways) and you should get the financial reward from it.� This isn't a charity, it's a service, and I would treat it as such.� Keep up the awesome!

-- 
Cheers,

Aaron Bedra
--
Clojure/core
http://clojure.com


On 04/19/2011 01:10 PM, rob levy wrote:
This seems great.� The $20 bothers me, not because I don't want to pay it, I would gladly donate this meager amount for such a useful resource.� There's just something in poor taste about not making this open to everyone.� And there's an implicit camaraderie and good will that developer communities have come to expect that makes this paywall seem weird and unwelcoming.� If you framed this as a donation, with access not contingent on donation, it would be perfectly fine-- and people might actually use it.

On Tue, Apr 19, 2011 at 12:45 PM, Paul deGrandis <paul.de...@gmail.com> wrote:
This is a great piece visualization for Clojure and very much how I
think about the language as I'm working with it (based on the pictures
and descriptions). �This is a nice niche piece of documentation for

the community, power users, and newly emerging Clojure shops.

Is your freemium model limiting namespaces/content. functionality, or
both?

Paul


On Apr 19, 9:27�am, Ambrose Bonnaire-Sergeant

<abonnaireserge...@gmail.com> wrote:
> Oh wow, this looks exciting! Subbed.
>
> Ambrose
>
> On Wed, Apr 20, 2011 at 12:19 AM, Chas Emerick <cemer...@snowtide.com>wrote:
>
>
>
>
>
>
>
> > Today, I�m opening up a �preview� site for Clojure Atlas [1], a new side
> > project of mine that I�m particularly excited about.

>
> > Clojure Atlas is an experiment in visualizing a programming language and
> > its standard library. �I�ve long been frustrated with the limitations of
> > text in programming, and this is my attempt to do something about it. �From
> > the site:
>
> > While Clojure Atlas has a number of *raisons d��tre*, it fundamentally
> > exists because I�ve consistently thought that typical programming language
> > and API references � being, in general, walls of text and alphabetized links
> > � are really poor at conveying the most important information: not the
> > minutiae of function signatures and class hierarchies, but the stuff that�s
> > �between the lines�, the context and interrelationships between such things

> > that too often are only discovered and internalized by bumping into them in
> > the course of programming. This is especially true if we�re learning a

> > language and its libraries (really, a never-ending process given the march
> > of progress), and what�s standing in our way is not, for example, being able

> > to easily access the documentation or signature for a particular known
> > function, but *discovering* the mere existence of a previously-unknown
> > function that is perfect for our needs at a given moment.
>
> > This is just a preview � all sizzle and no steak, as it were. �I�m working

> > away at the ontology that drives the visualization and user experience, but
> > I want to get some more early (quiet) feedback from a few folks to make sure
> > I�m not committing egregious sins in various ways before throwing open the
> > doors to the world.
>
> > In the meantime, if you�re really interested, follow @ClojureAtlas [2],

Aaron Bedra

unread,
Apr 19, 2011, 1:26:00 PM4/19/11
to clo...@googlegroups.com
Also, when I mean "per project", I mean that in the sense that I am working with different customers who would find it valuable and pay for the access for them :)


-- 
Cheers,

Aaron Bedra
--
Clojure/core
http://clojure.com


Chas Emerick

unread,
Apr 19, 2011, 1:33:47 PM4/19/11
to clo...@googlegroups.com
Duly noted Aaron, and thanks. :-)

- Chas

On Apr 19, 2011, at 1:23 PM, Aaron Bedra wrote:

I would pay $20 per project for this easily.  You did some great work (from the looks of it anyways) and you should get the financial reward from it.  This isn't a charity, it's a service, and I would treat it as such.  Keep up the awesome!

rob levy

unread,
Apr 19, 2011, 1:37:26 PM4/19/11
to clo...@googlegroups.com
I think there might be something I don't get about the "hand-curated" aspect.  It would be great if it could be crowd sourced, with the kinds of heterarchical guarantees of quality and expertise that have served services like StackOverflow and Wikipedia so well.

On Tue, Apr 19, 2011 at 1:26 PM, Aaron Bedra <aaron...@gmail.com> wrote:
Also, when I mean "per project", I mean that in the sense that I am working with different customers who would find it valuable and pay for the access for them :)


-- 
Cheers,

Aaron Bedra
--
Clojure/core
http://clojure.com


On 04/19/2011 01:23 PM, Aaron Bedra wrote:
I would pay $20 per project for this easily.  You did some great work (from the looks of it anyways) and you should get the financial reward from it.  This isn't a charity, it's a service, and I would treat it as such.  Keep up the awesome!

-- 
Cheers,

Aaron Bedra
--
Clojure/core
http://clojure.com


Brenton

unread,
Apr 19, 2011, 1:39:00 PM4/19/11
to Clojure
Great work Chas!

I can't wait to try it out (and pay for it).

Chas Emerick

unread,
Apr 19, 2011, 1:39:54 PM4/19/11
to clo...@googlegroups.com

On Apr 19, 2011, at 1:10 PM, rob levy wrote:

> This seems great. The $20 bothers me, not because I don't want to pay it, I would gladly donate this meager amount for such a useful resource. There's just something in poor taste about not making this open to everyone. And there's an implicit camaraderie and good will that developer communities have come to expect that makes this paywall seem weird and unwelcoming. If you framed this as a donation, with access not contingent on donation, it would be perfectly fine-- and people might actually use it.

If people feel that the work is worthwhile, they'll pay, if not, they won't. I suspect that I'll end up sinking about a full man-month into the ontology when all is said and done (with incremental improvements as later versions of Clojure are released, etc) so I don't feel badly about charging real money for that, and being honest and direct about the nature of the transaction. Nevermind the effort around the UX, etc.

Really, I'd wish more developers would charge reasonable amounts for tools that they work on for free in their spare time; perhaps more of them would work on them full-time, and we'd have better tools!

Anyway, it's just a preview site at the moment -- there's no "paywall" anywhere.

- Chas

Ulises

unread,
Apr 19, 2011, 1:42:08 PM4/19/11
to clo...@googlegroups.com
I just clicked on "Try it" and only got to a short blurb and a
subscribe form. Is this the right behaviour?

U

Chas Emerick

unread,
Apr 19, 2011, 1:42:55 PM4/19/11
to clo...@googlegroups.com
On Apr 19, 2011, at 12:45 PM, Paul deGrandis wrote:

> This is a great piece visualization for Clojure and very much how I
> think about the language as I'm working with it (based on the pictures
> and descriptions). This is a nice niche piece of documentation for
> the community, power users, and newly emerging Clojure shops.

Thank you for the vote of confidence. I hope the final experience matches your expectations.

> Is your freemium model limiting namespaces/content. functionality, or
> both?

I've not yet decided what non-members will see; there will probably be some experimentation around that. I'd like it to be useful on its own merits, but I obviously would like to see people that would get value out of the full version join up. I'm guessing some kind of nagware will be my baseline (e.g. traverse N nodes in the graph, and you start to get nag dialogs), and we'll see how it goes from there.

- Chas

rob levy

unread,
Apr 19, 2011, 1:49:22 PM4/19/11
to clo...@googlegroups.com
Again, it's not that *I* wouldn't pay, it just seems unfortunate that most people won't get to use it.  Whether right or misguided, there is a culture of free as in free beer on the net, that will result in most not giving it a chance.  A separate but related issue is the advantage of free as in freedom; if designed for collaborative content development, that would make the service more actively used and free of errors, and more scalable to include models of other libraries, with library developers using the tool to model their own new libraries.


--

Chas Emerick

unread,
Apr 19, 2011, 1:51:35 PM4/19/11
to clo...@googlegroups.com

On Apr 19, 2011, at 1:42 PM, Ulises wrote:

> I just clicked on "Try it" and only got to a short blurb and a
> subscribe form. Is this the right behaviour?

Indeed. As I say nearby, the app isn't quite ready for public consumption yet. I put the site up now so as to garner some early feedback and indications of interest.

If you subscribe to updates by email or follow @ClojureAtlas, you'll know in short order when there's something real to use.

Sorry for any confusion! :-)

- Chas

Chas Emerick

unread,
Apr 19, 2011, 2:04:22 PM4/19/11
to clo...@googlegroups.com
Assuming people find this sort of presentation useful, I would very much like to see it used to model other libraries and such.  One step at a time…

Crowdsourcing is a good model for some things, but I don't think it's a panacea.  I know I'd rather have original authors build the ontologies associated with their libraries (again, cart before horse here) than functionally-anonymous masses doing so.  I'm no replacement for Rich in this regard, but I can at least guarantee that there will be a consistency to the model and a sole point of accountability for its quality.  A good balance might be flagging, where the community/membership can flag errors, suggest additions, etc; the uservoice tab (which will be included in the actual visualization) is an informal step towards that.

- Chas

Andy Fingerhut

unread,
Apr 19, 2011, 3:50:16 PM4/19/11
to clo...@googlegroups.com
I'm signed up for future notices.

Think of it like a book about Clojure and some of its libraries on a web site, except it is more index than prose.  People seem to give books a chance quite often, if they are informative enough.  (Chas, feel free to use an analogy like that on the web site.  That and "for the price of only 6 medium lattes, you get ...")

Yes, I understand your point that books are usually evaluated differently than web sites.  "There is a culture of free as in free beer on the net, that will result in most not giving it a chance".  If a person doesn't give it a chance because of that culture, and they would get more than $20 of benefit from paying for it (a free sample making this easier to judge), the ideas they have accepted from that culture should be given more careful thought.  If people judge whether it is worth paying for sources of information solely by the form in which they are delivered, it reminds me of a popular saying about books and their covers.

I could easily imagine Chas creating something more useful than existing web sites currently are, in a relatively short amount of time (i.e. weeks), if he is interested in focusing on it.

Andy

Fred Concklin

unread,
Apr 19, 2011, 8:31:13 PM4/19/11
to clo...@googlegroups.com
Just a thought, but you could use something like gitcred to give it away
for free if people meet a certain threshold for involvement in the
clojure ecosystem. This also might incentivize clojure development and
allow you to offer it free to authors whose libraries are in your graph.

https://github.com/mmcgrana/gitcred

Chas Emerick <ceme...@snowtide.com> writes:

> --
> You received this message because you are subscribed to the Google
> Groups "Clojure" group.
> To post to this group, send email to clo...@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+u...@googlegroups.com
> For more options, visit this group at
> http://groups.google.com/group/clojure?hl=en

- Fred Concklin

Meikel Brandmeyer

unread,
Apr 20, 2011, 1:49:05 AM4/20/11
to Clojure
Hi,

On 20 Apr., 02:31, Fred Concklin <fredconck...@gmail.com> wrote:

> Just a thought, but you could use something like gitcred to give it away
> for free if people meet a certain threshold for involvement in the
> clojure ecosystem. This also might incentivize clojure development and
> allow you to offer it free to authors whose libraries are in your graph.

An interesting thought, but I find this hard to measure. What would be
included? github alone is certainly not sufficient. Also scan
gitorious? bitbucket? google code? postings to the list(s)?
stackoverflow?

Sincerely
Meikel
Reply all
Reply to author
Forward
0 new messages