Re: ClojureDocs example management?

2017-06-19 Thread Mars0i 
> I think part of it is that examples are easy to edit, so if there are small 
> easily fixed mistakes, often someone will.

Ah, I didn't realize that anyone can edit others' examples.

The two cases in which I've seen complaints about bad community 
help/examples/etc. concerned very popular languages.  My speculation is that 
beyond a certain level of popularity, the absolute number of foolish people can 
hurt a site if they foolishly post and their posts aren't cleaned up.  Maybe 
Clojure fans are all good thoughtful, careful people who never make foolish 
mistakes simply because there aren't enough of us.

-- 
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 unsubscribe from this group and stop receiving emails from it, send an email 
to clojure+unsubscr...@googlegroups.com.
For more options, visit https://groups.google.com/d/optout.

Re: ClojureDocs example management?

2017-06-18 Thread Andy Fingerhut 
I think part of it is that examples are easy to edit, so if there are small
easily fixed mistakes, often someone will.

Unlike politically contentious issues on Wikipedia, there isn't much to be
gained from putting misleading information in ClojureDocs.

Andy

On Sun, Jun 18, 2017 at 7:53 PM, Alex Miller  wrote:

> I believe Lee Hinman was the original maintainer of ClojureDocs and it's
> mostly Zachary Kim now.
>
> Reop is at: https://github.com/zk/clojuredocs although the data is not
> publicly available other than through the site afaik.
>
> I'm not sure how much editing it receives right now. In general, I think
> most of the examples are reasonably good and/or there are corrections in
> later comments.
>
> Some factors that I think are in our collective favor are:
> - Clojure favors stability and backwards compatibility so in general it's
> pretty rare for examples to break over time
> - Most examples are 1-liners that are easy to put in a REPL and verify
> yourself
> - Clojure fans are all good thoughtful, careful people who never make
> foolish mistakes
>
>
> On Sunday, June 18, 2017 at 9:13:16 PM UTC-5, Mars0i wrote:
>>
>> Who polices ClojureDocs?  If someone adds a silly or simply incorrect
>> example, does someone eventually remove it?  Are there ever spam-like
>> "examples"?  Or are Clojure fans all good, thoughtful, careful people who
>> never make foolish mistakes?
>>
>> I'm curious because I see no sign that anyone polices ClojureDocs, and it
>> nevertheless seems like a uniformly useful resource.  The only flaws I've
>> experienced came when I thought something was missing--and then it was easy
>> enough to add an example or crossreference link myself.
>>
>> I'm asking because of a conversation in another language-centered
>> community where a worry was expressed that a community-contributed examples
>> website would end up full of junk--bad examples, etc.  Supposedly some
>> sites end up that way.  What's our secret?
>>
> --
> 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 unsubscribe from this group and stop receiving emails from it, send an
> email to clojure+unsubscr...@googlegroups.com.
> For more options, visit https://groups.google.com/d/optout.
>

-- 
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 unsubscribe from this group and stop receiving emails from it, send an email 
to clojure+unsubscr...@googlegroups.com.
For more options, visit https://groups.google.com/d/optout.

Re: ClojureDocs example management?

2017-06-18 Thread Alex Miller 
I believe Lee Hinman was the original maintainer of ClojureDocs and it's 
mostly Zachary Kim now.

Reop is at: https://github.com/zk/clojuredocs although the data is not 
publicly available other than through the site afaik.

I'm not sure how much editing it receives right now. In general, I think 
most of the examples are reasonably good and/or there are corrections in 
later comments. 

Some factors that I think are in our collective favor are:
- Clojure favors stability and backwards compatibility so in general it's 
pretty rare for examples to break over time
- Most examples are 1-liners that are easy to put in a REPL and verify 
yourself
- Clojure fans are all good thoughtful, careful people who never make 
foolish mistakes


On Sunday, June 18, 2017 at 9:13:16 PM UTC-5, Mars0i wrote:
>
> Who polices ClojureDocs?  If someone adds a silly or simply incorrect 
> example, does someone eventually remove it?  Are there ever spam-like 
> "examples"?  Or are Clojure fans all good, thoughtful, careful people who 
> never make foolish mistakes?
>
> I'm curious because I see no sign that anyone polices ClojureDocs, and it 
> nevertheless seems like a uniformly useful resource.  The only flaws I've 
> experienced came when I thought something was missing--and then it was easy 
> enough to add an example or crossreference link myself.
>
> I'm asking because of a conversation in another language-centered 
> community where a worry was expressed that a community-contributed examples 
> website would end up full of junk--bad examples, etc.  Supposedly some 
> sites end up that way.  What's our secret?
>

-- 
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 unsubscribe from this group and stop receiving emails from it, send an email 
to clojure+unsubscr...@googlegroups.com.
For more options, visit https://groups.google.com/d/optout.

ClojureDocs example management?

2017-06-18 Thread Mars0i 
Who polices ClojureDocs?  If someone adds a silly or simply incorrect 
example, does someone eventually remove it?  Are there ever spam-like 
"examples"?  Or are Clojure fans all good, thoughtful, careful people who 
never make foolish mistakes?

I'm curious because I see no sign that anyone polices ClojureDocs, and it 
nevertheless seems like a uniformly useful resource.  The only flaws I've 
experienced came when I thought something was missing--and then it was easy 
enough to add an example or crossreference link myself.

I'm asking because of a conversation in another language-centered community 
where a worry was expressed that a community-contributed examples website 
would end up full of junk--bad examples, etc.  Supposedly some sites end up 
that way.  What's our secret?

-- 
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 unsubscribe from this group and stop receiving emails from it, send an email 
to clojure+unsubscr...@googlegroups.com.
For more options, visit https://groups.google.com/d/optout.