Re: Improving visibility of clojure-doc.org
If one of those is that Clojure documentation site that has a paywall, I object unless the merged site has no paywall. Official and officially-endorsed documentation for open source software should not be behind a paywall. On Tue, Mar 12, 2013 at 1:47 AM, kinleyd kinl...@gmail.com wrote: I also found clojure-doc.org accidentally, and was surprised it didn't show up in earlier searches, especially in the context of the high quality of the documentation. I think merging the two resources (clojuredocs and clojure-doc) would greatly help (I'd be happy to help in this effort), and getting high profile links pointed to it (particularly on clojure.org itself) would make all the difference in adding to its visibility, regardless of the frequency of the updates to the site itself. On Thursday, February 28, 2013 12:06:46 AM UTC+6, Michael Klishin wrote: Started in October 2012, http://clojure-doc.org is a pretty extensive community documentation effort. It covers Clojure, its ecosystem and tools and has two key goals: * We produce beginner-friendly content * It is dead easy to join and help Even though recently that hasn't been as much activity as in the past, it is not abandoned and continues to accumulate useful, beginner-friendly material. We constantly get praises from newcomers to Clojure who discover clojure-doc.org. Unfortunately, it does not appear even in top 10 in Google for clojure docs or clojure documentation and many community members are not aware of it. In part it is less visible because we no longer actively post progress reports. Things have settled down and most of changes now are small edits and improvements all over the place. It is a bit pointless to post progress reports more often than once a month or so. So I'd like to start a discussion about what can be done about it. The community (we have 40 contributors) has worked very hard on clojure-doc.org and I'd like to see high profile resources (namly clojure.org and leiningen.org) link to it. What would it take to convince clojure.org maintainers to do so? There are still guides left ot be written (macros, gen-class), but overall, I'd say there is no better source of freely available, beginner-friendly, hackable (no Clojure CA, everything is developed on GitHub [1], content is in Markdown) documentation. All it needs is some linking and promotion love. One way to help would be to start a campaign such as Mozilla's Promote JS [docs]. Unfortunately, unlike Mozilla key contributors behind clojure-doc.org largely lack graphic and Web design skills, so replicating that campaing is probably not an option. Do you have any ideas about how we can make clojure-doc.org more visible? Do you know who can help with getting a link from clojure.org? Do you think clojure-doc.org is not good enough to be the blessed open source documentation resource? Please post your suggestions and concerns. Improving CDS visibility will benefit the entire community plus all the people who will join it in the future. Most of the work is already done, it just needs to be promoted better. Thanks you. 1. https://github.com/**clojuredocs/cdshttps://github.com/clojuredocs/cds -- MK http://github.com/**michaelklishin http://github.com/michaelklishin http://twitter.com/**michaelklishin http://twitter.com/michaelklishin -- -- 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/groups/opt_out. -- -- 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/groups/opt_out.
Re: Improving visibility of clojure-doc.org
On Mar 11, 2013, at 23:20, Cedric Greevey wrote: If one of those is that Clojure documentation site that has a paywall, I object unless the merged site has no paywall. Official and officially- endorsed documentation for open source software should not be behind a paywall. Neither site is behind a paywall (as you would have discovered had you bothered to look :-/). Clojure Atlas _is_ behind a (cheap) paywall; I think it's well worth the money, but suit yourself... -r -- http://www.cfcl.com/rdmRich Morin http://www.cfcl.com/rdm/resume r...@cfcl.com http://www.cfcl.com/rdm/weblog +1 650-873-7841 Software system design, development, and documentation -- -- 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/groups/opt_out.
Re: Improving visibility of clojure-doc.org
It's quite confusing that http://clojure-doc.org and http://www.clojure-doc.org go to different pages. -- -- 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/groups/opt_out.
Re: Improving visibility of clojure-doc.org
2013/3/12 Cedric Greevey cgree...@gmail.com If one of those is that Clojure documentation site that has a paywall, I object unless the merged site has no paywall. Official and officially-endorsed documentation for open source software should not be behind a paywall. Why don't you go to http://clojure-doc.org and see if it has a paywall. -- MK http://github.com/michaelklishin http://twitter.com/michaelklishin -- -- 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/groups/opt_out.
Re: Improving visibility of clojure-doc.org
2013/3/12 Robert Stuttaford robert.stuttaf...@gmail.com Has this effort started up yet? Is there a github url? I'd really love to see clojuredocs.org showing the 1.5 apis. Willing to help make that happen! I think the repos are https://github.com/dakrone/eisago https://github.com/dakrone/cadastre -- MK http://github.com/michaelklishin http://twitter.com/michaelklishin -- -- 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/groups/opt_out.
Re: Improving visibility of clojure-doc.org
2013/3/12 Devin Walters dev...@gmail.com I assume this has been discussed to death already, but isn't there some way to get clojure-doc and clojuredocs to live under the same umbrella? We can host all relevant projects under the same GitHub org, that's a good idea. Merging two resources into one seems completely unnecessary to me. We can always have them link to each other in the navigation bar but there's too much difference in how each of them works (a Clojure analyzer + web app vs. a static site in Markdown) to try to combine them into a single code base. We can also have reference.clojure-doc.org or api.clojure-doc.org that redirects to clojuredocs.org. Another idea I'd like to throw out there: I have the domains getclojure.org/com. Since clojure-doc.org is all about getting clojure, it seems like it might be an appropriate home for clojure-doc. At the very least it would kill some of the ambiguity between clojuredocs and clojure-doc. To me getclojure.org sounds like something you would download Clojure from. -- MK http://github.com/michaelklishin http://twitter.com/michaelklishin -- -- 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/groups/opt_out.
Re: Improving visibility of clojure-doc.org
I assume this has been discussed to death already, but isn't there some way to get clojure-doc and clojuredocs to live under the same umbrella? Another idea I'd like to throw out there: I have the domains getclojure.org/com. Since clojure-doc.org is all about getting clojure, it seems like it might be an appropriate home for clojure-doc. At the very least it would kill some of the ambiguity between clojuredocs and clojure-doc. Something to think about, Devin On Wednesday, February 27, 2013 12:06:46 PM UTC-6, Michael Klishin wrote: Started in October 2012, http://clojure-doc.org is a pretty extensive community documentation effort. It covers Clojure, its ecosystem and tools and has two key goals: * We produce beginner-friendly content * It is dead easy to join and help Even though recently that hasn't been as much activity as in the past, it is not abandoned and continues to accumulate useful, beginner-friendly material. We constantly get praises from newcomers to Clojure who discover clojure-doc.org. Unfortunately, it does not appear even in top 10 in Google for clojure docs or clojure documentation and many community members are not aware of it. In part it is less visible because we no longer actively post progress reports. Things have settled down and most of changes now are small edits and improvements all over the place. It is a bit pointless to post progress reports more often than once a month or so. So I'd like to start a discussion about what can be done about it. The community (we have 40 contributors) has worked very hard on clojure-doc.org and I'd like to see high profile resources (namly clojure.org and leiningen.org) link to it. What would it take to convince clojure.org maintainers to do so? There are still guides left ot be written (macros, gen-class), but overall, I'd say there is no better source of freely available, beginner-friendly, hackable (no Clojure CA, everything is developed on GitHub [1], content is in Markdown) documentation. All it needs is some linking and promotion love. One way to help would be to start a campaign such as Mozilla's Promote JS [docs]. Unfortunately, unlike Mozilla key contributors behind clojure-doc.org largely lack graphic and Web design skills, so replicating that campaing is probably not an option. Do you have any ideas about how we can make clojure-doc.org more visible? Do you know who can help with getting a link from clojure.org? Do you think clojure-doc.org is not good enough to be the blessed open source documentation resource? Please post your suggestions and concerns. Improving CDS visibility will benefit the entire community plus all the people who will join it in the future. Most of the work is already done, it just needs to be promoted better. Thanks you. 1. https://github.com/clojuredocs/cds -- MK http://github.com/michaelklishin http://twitter.com/michaelklishin -- -- 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/groups/opt_out.
Re: Improving visibility of clojure-doc.org
Devin Walters writes: I assume this has been discussed to death already, but isn't there some way to get clojure-doc and clojuredocs to live under the same umbrella? I believe this is the plan; it's just blocked on not having the manpower to port clojuredocs.org's web UI off Rails and build a Clojure HTML interface for it. Volunteers welcome. -Phil -- -- 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/groups/opt_out.
Re: Improving visibility of clojure-doc.org
Has this effort started up yet? Is there a github url? I'd really love to see clojuredocs.org showing the 1.5 apis. Willing to help make that happen! On Tuesday, March 12, 2013 12:03:22 AM UTC+2, Phil Hagelberg wrote: Devin Walters writes: I assume this has been discussed to death already, but isn't there some way to get clojure-doc and clojuredocs to live under the same umbrella? I believe this is the plan; it's just blocked on not having the manpower to port clojuredocs.org's web UI off Rails and build a Clojure HTML interface for it. Volunteers welcome. -Phil -- -- 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/groups/opt_out.
Re: Improving visibility of clojure-doc.org
I also found clojure-doc.org accidentally, and was surprised it didn't show up in earlier searches, especially in the context of the high quality of the documentation. I think merging the two resources (clojuredocs and clojure-doc) would greatly help (I'd be happy to help in this effort), and getting high profile links pointed to it (particularly on clojure.org itself) would make all the difference in adding to its visibility, regardless of the frequency of the updates to the site itself. On Thursday, February 28, 2013 12:06:46 AM UTC+6, Michael Klishin wrote: Started in October 2012, http://clojure-doc.org is a pretty extensive community documentation effort. It covers Clojure, its ecosystem and tools and has two key goals: * We produce beginner-friendly content * It is dead easy to join and help Even though recently that hasn't been as much activity as in the past, it is not abandoned and continues to accumulate useful, beginner-friendly material. We constantly get praises from newcomers to Clojure who discover clojure-doc.org. Unfortunately, it does not appear even in top 10 in Google for clojure docs or clojure documentation and many community members are not aware of it. In part it is less visible because we no longer actively post progress reports. Things have settled down and most of changes now are small edits and improvements all over the place. It is a bit pointless to post progress reports more often than once a month or so. So I'd like to start a discussion about what can be done about it. The community (we have 40 contributors) has worked very hard on clojure-doc.org and I'd like to see high profile resources (namly clojure.org and leiningen.org) link to it. What would it take to convince clojure.org maintainers to do so? There are still guides left ot be written (macros, gen-class), but overall, I'd say there is no better source of freely available, beginner-friendly, hackable (no Clojure CA, everything is developed on GitHub [1], content is in Markdown) documentation. All it needs is some linking and promotion love. One way to help would be to start a campaign such as Mozilla's Promote JS [docs]. Unfortunately, unlike Mozilla key contributors behind clojure-doc.org largely lack graphic and Web design skills, so replicating that campaing is probably not an option. Do you have any ideas about how we can make clojure-doc.org more visible? Do you know who can help with getting a link from clojure.org? Do you think clojure-doc.org is not good enough to be the blessed open source documentation resource? Please post your suggestions and concerns. Improving CDS visibility will benefit the entire community plus all the people who will join it in the future. Most of the work is already done, it just needs to be promoted better. Thanks you. 1. https://github.com/clojuredocs/cds -- MK http://github.com/michaelklishin http://twitter.com/michaelklishin -- -- 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/groups/opt_out.
Re: Improving visibility of clojure-doc.org
With the aim of increasing exposure, have you covered off boring SEO things like having a sitemap.xml and verifying the domain with Webmaster tools? I couldn't find a sitemap, but it does look like the content has been indexed by Google. On another note, I wonder whether it's worth clarifying the position of the site in relation to the other Clojure Documentations out there. I've often thought it's a shame to see http://clojuredocs.org/ fall out of regular updates. Having an up to date, searchable reference is one of the best things for a language to have. Is this likely to be rolled into clojure-doc in the future? Are they sister sites? If you want help bringing the http://clojuredocs.org/ site up to date I'd be happy to offer some time. I put together some Overtone docs based on a fork of it so I feel like I'm up to speed with the whole thing - you can see my fork here http://overtone-docs.herokuapp.com/ Thanks, On Wednesday, February 27, 2013 6:06:46 PM UTC, Michael Klishin wrote: Started in October 2012, http://clojure-doc.org is a pretty extensive community documentation effort. It covers Clojure, its ecosystem and tools and has two key goals: * We produce beginner-friendly content * It is dead easy to join and help Even though recently that hasn't been as much activity as in the past, it is not abandoned and continues to accumulate useful, beginner-friendly material. We constantly get praises from newcomers to Clojure who discover clojure-doc.org. Unfortunately, it does not appear even in top 10 in Google for clojure docs or clojure documentation and many community members are not aware of it. In part it is less visible because we no longer actively post progress reports. Things have settled down and most of changes now are small edits and improvements all over the place. It is a bit pointless to post progress reports more often than once a month or so. So I'd like to start a discussion about what can be done about it. The community (we have 40 contributors) has worked very hard on clojure-doc.org and I'd like to see high profile resources (namly clojure.org and leiningen.org) link to it. What would it take to convince clojure.org maintainers to do so? There are still guides left ot be written (macros, gen-class), but overall, I'd say there is no better source of freely available, beginner-friendly, hackable (no Clojure CA, everything is developed on GitHub [1], content is in Markdown) documentation. All it needs is some linking and promotion love. One way to help would be to start a campaign such as Mozilla's Promote JS [docs]. Unfortunately, unlike Mozilla key contributors behind clojure-doc.org largely lack graphic and Web design skills, so replicating that campaing is probably not an option. Do you have any ideas about how we can make clojure-doc.org more visible? Do you know who can help with getting a link from clojure.org? Do you think clojure-doc.org is not good enough to be the blessed open source documentation resource? Please post your suggestions and concerns. Improving CDS visibility will benefit the entire community plus all the people who will join it in the future. Most of the work is already done, it just needs to be promoted better. Thanks you. 1. https://github.com/clojuredocs/cds -- MK http://github.com/michaelklishin http://twitter.com/michaelklishin -- -- 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/groups/opt_out.
Re: Improving visibility of clojure-doc.org
2013/2/28 xavriley i...@xavierriley.co.uk On another note, I wonder whether it's worth clarifying the position of the site in relation to the other Clojure Documentations out there. I've often thought it's a shame to see http://clojuredocs.org/ fall out of regular updates. Having an up to date, searchable reference is one of the best things for a language to have. Is this likely to be rolled into clojure-doc in the future? clojuredocs.org is API reference. clojure-doc.org is guides and tutorials. -- MK http://github.com/michaelklishin http://twitter.com/michaelklishin -- -- 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/groups/opt_out.
Re: Improving visibility of clojure-doc.org
The ordinary visitor might be forgiven for expecting that both would be found under someplace like Clojure.org... just a thought. -A On Feb 28, 2013 2:04 AM, Michael Klishin michael.s.klis...@gmail.com wrote: 2013/2/28 xavriley i...@xavierriley.co.uk On another note, I wonder whether it's worth clarifying the position of the site in relation to the other Clojure Documentations out there. I've often thought it's a shame to see http://clojuredocs.org/ fall out of regular updates. Having an up to date, searchable reference is one of the best things for a language to have. Is this likely to be rolled into clojure-doc in the future? clojuredocs.org is API reference. clojure-doc.org is guides and tutorials. -- MK http://github.com/michaelklishin http://twitter.com/michaelklishin -- -- 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/groups/opt_out. -- -- 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/groups/opt_out.
Re: Improving visibility of clojure-doc.org
I added a link to http://clojure-doc.org in this two wikipedia's pages: http://en.wikipedia.org/wiki/Clojure http://es.wikipedia.org/wiki/Clojure (*see*: external links) Thanks Michael for your site. Is very useful. Miguel -- -- 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/groups/opt_out.
Improving visibility of clojure-doc.org
Started in October 2012, http://clojure-doc.org is a pretty extensive community documentation effort. It covers Clojure, its ecosystem and tools and has two key goals: * We produce beginner-friendly content * It is dead easy to join and help Even though recently that hasn't been as much activity as in the past, it is not abandoned and continues to accumulate useful, beginner-friendly material. We constantly get praises from newcomers to Clojure who discover clojure-doc.org. Unfortunately, it does not appear even in top 10 in Google for clojure docs or clojure documentation and many community members are not aware of it. In part it is less visible because we no longer actively post progress reports. Things have settled down and most of changes now are small edits and improvements all over the place. It is a bit pointless to post progress reports more often than once a month or so. So I'd like to start a discussion about what can be done about it. The community (we have 40 contributors) has worked very hard on clojure-doc.org and I'd like to see high profile resources (namly clojure.org and leiningen.org) link to it. What would it take to convince clojure.org maintainers to do so? There are still guides left ot be written (macros, gen-class), but overall, I'd say there is no better source of freely available, beginner-friendly, hackable (no Clojure CA, everything is developed on GitHub [1], content is in Markdown) documentation. All it needs is some linking and promotion love. One way to help would be to start a campaign such as Mozilla's Promote JS [docs]. Unfortunately, unlike Mozilla key contributors behind clojure-doc.org largely lack graphic and Web design skills, so replicating that campaing is probably not an option. Do you have any ideas about how we can make clojure-doc.org more visible? Do you know who can help with getting a link from clojure.org? Do you think clojure-doc.org is not good enough to be the blessed open source documentation resource? Please post your suggestions and concerns. Improving CDS visibility will benefit the entire community plus all the people who will join it in the future. Most of the work is already done, it just needs to be promoted better. Thanks you. 1. https://github.com/clojuredocs/cds -- MK http://github.com/michaelklishin http://twitter.com/michaelklishin -- -- 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/groups/opt_out.
Re: Improving visibility of clojure-doc.org
How about introducing a section with solutions to this ( http://projecteuler.net/problems) or other problems. While most of us beginners can write clojure code, solving problems in an idiomatic way is another story. You could have a page for each question and users can each attempt and learn from each others attempts. Just a suggestion. Josh. On Wed, Feb 27, 2013 at 9:06 PM, Michael Klishin michael.s.klis...@gmail.com wrote: Started in October 2012, http://clojure-doc.org is a pretty extensive community documentation effort. It covers Clojure, its ecosystem and tools and has two key goals: * We produce beginner-friendly content * It is dead easy to join and help Even though recently that hasn't been as much activity as in the past, it is not abandoned and continues to accumulate useful, beginner-friendly material. We constantly get praises from newcomers to Clojure who discover clojure-doc.org. Unfortunately, it does not appear even in top 10 in Google for clojure docs or clojure documentation and many community members are not aware of it. In part it is less visible because we no longer actively post progress reports. Things have settled down and most of changes now are small edits and improvements all over the place. It is a bit pointless to post progress reports more often than once a month or so. So I'd like to start a discussion about what can be done about it. The community (we have 40 contributors) has worked very hard on clojure-doc.org and I'd like to see high profile resources (namly clojure.org and leiningen.org) link to it. What would it take to convince clojure.org maintainers to do so? There are still guides left ot be written (macros, gen-class), but overall, I'd say there is no better source of freely available, beginner-friendly, hackable (no Clojure CA, everything is developed on GitHub [1], content is in Markdown) documentation. All it needs is some linking and promotion love. One way to help would be to start a campaign such as Mozilla's Promote JS [docs]. Unfortunately, unlike Mozilla key contributors behind clojure-doc.org largely lack graphic and Web design skills, so replicating that campaing is probably not an option. Do you have any ideas about how we can make clojure-doc.org more visible? Do you know who can help with getting a link from clojure.org? Do you think clojure-doc.org is not good enough to be the blessed open source documentation resource? Please post your suggestions and concerns. Improving CDS visibility will benefit the entire community plus all the people who will join it in the future. Most of the work is already done, it just needs to be promoted better. Thanks you. 1. https://github.com/clojuredocs/cds -- MK http://github.com/michaelklishin http://twitter.com/michaelklishin -- -- 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/groups/opt_out. -- -- 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/groups/opt_out.
Re: [clj-power] Improving visibility of clojure-doc.org
FWIW, I've added a permanent link to clojure-doc.org from my blog with the link text Clojure Documentation - perhaps others who have blogs could do the same? I was looking at meetup.com to see if I could easily find a way to add resources / links to a group's home page, thinking it would be a good link to have there (Bay Area Clojure User Group). Anyone know enough about meetup.com to point me in the right direction there? Sean On Wed, Feb 27, 2013 at 10:06 AM, Michael Klishin michael.s.klis...@gmail.com wrote: Started in October 2012, http://clojure-doc.org is a pretty extensive community documentation effort. It covers Clojure, its ecosystem and tools and has two key goals: * We produce beginner-friendly content * It is dead easy to join and help Even though recently that hasn't been as much activity as in the past, it is not abandoned and continues to accumulate useful, beginner-friendly material. We constantly get praises from newcomers to Clojure who discover clojure-doc.org. Unfortunately, it does not appear even in top 10 in Google for clojure docs or clojure documentation and many community members are not aware of it. In part it is less visible because we no longer actively post progress reports. Things have settled down and most of changes now are small edits and improvements all over the place. It is a bit pointless to post progress reports more often than once a month or so. So I'd like to start a discussion about what can be done about it. The community (we have 40 contributors) has worked very hard on clojure-doc.org and I'd like to see high profile resources (namly clojure.org and leiningen.org) link to it. What would it take to convince clojure.org maintainers to do so? There are still guides left ot be written (macros, gen-class), but overall, I'd say there is no better source of freely available, beginner-friendly, hackable (no Clojure CA, everything is developed on GitHub [1], content is in Markdown) documentation. All it needs is some linking and promotion love. One way to help would be to start a campaign such as Mozilla's Promote JS [docs]. Unfortunately, unlike Mozilla key contributors behind clojure-doc.org largely lack graphic and Web design skills, so replicating that campaing is probably not an option. Do you have any ideas about how we can make clojure-doc.org more visible? Do you know who can help with getting a link from clojure.org? Do you think clojure-doc.org is not good enough to be the blessed open source documentation resource? Please post your suggestions and concerns. Improving CDS visibility will benefit the entire community plus all the people who will join it in the future. Most of the work is already done, it just needs to be promoted better. Thanks you. 1. https://github.com/clojuredocs/cds -- MK http://github.com/michaelklishin http://twitter.com/michaelklishin -- You received this message because you are subscribed to the Google Groups clojure-power group. To unsubscribe from this group and stop receiving emails from it, send an email to clojure-power+unsubscr...@googlegroups.com. To post to this group, send email to clojure-po...@googlegroups.com. Visit this group at http://groups.google.com/group/clojure-power?hl=en. For more options, visit https://groups.google.com/groups/opt_out. -- Sean A Corfield -- (904) 302-SEAN An Architect's View -- http://corfield.org/ World Singles, LLC. -- http://worldsingles.com/ Perfection is the enemy of the good. -- Gustave Flaubert, French realist novelist (1821-1880) -- -- 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/groups/opt_out.
Re: [clj-power] Improving visibility of clojure-doc.org
I've updated http://clojure.org/documentation to add a link to http://clojure-doc.org. I think it's a great resource for all Clojure developers!! I think it would be useful in your regular updates to highlight areas that could use help. Another area that I think would be useful in addition to the current docs are smallish examples of full projects that highlight how to put the existing pieces together into a (small) real project. Alex On Wed, Feb 27, 2013 at 12:06 PM, Michael Klishin michael.s.klis...@gmail.com wrote: Started in October 2012, http://clojure-doc.org is a pretty extensive community documentation effort. It covers Clojure, its ecosystem and tools and has two key goals: * We produce beginner-friendly content * It is dead easy to join and help Even though recently that hasn't been as much activity as in the past, it is not abandoned and continues to accumulate useful, beginner-friendly material. We constantly get praises from newcomers to Clojure who discover clojure-doc.org. Unfortunately, it does not appear even in top 10 in Google for clojure docs or clojure documentation and many community members are not aware of it. In part it is less visible because we no longer actively post progress reports. Things have settled down and most of changes now are small edits and improvements all over the place. It is a bit pointless to post progress reports more often than once a month or so. So I'd like to start a discussion about what can be done about it. The community (we have 40 contributors) has worked very hard on clojure-doc.org and I'd like to see high profile resources (namly clojure.org and leiningen.org) link to it. What would it take to convince clojure.org maintainers to do so? There are still guides left ot be written (macros, gen-class), but overall, I'd say there is no better source of freely available, beginner-friendly, hackable (no Clojure CA, everything is developed on GitHub [1], content is in Markdown) documentation. All it needs is some linking and promotion love. One way to help would be to start a campaign such as Mozilla's Promote JS [docs]. Unfortunately, unlike Mozilla key contributors behind clojure-doc.org largely lack graphic and Web design skills, so replicating that campaing is probably not an option. Do you have any ideas about how we can make clojure-doc.org more visible? Do you know who can help with getting a link from clojure.org? Do you think clojure-doc.org is not good enough to be the blessed open source documentation resource? Please post your suggestions and concerns. Improving CDS visibility will benefit the entire community plus all the people who will join it in the future. Most of the work is already done, it just needs to be promoted better. Thanks you. 1. https://github.com/clojuredocs/cds -- MK http://github.com/michaelklishin http://twitter.com/michaelklishin -- You received this message because you are subscribed to the Google Groups clojure-power group. To unsubscribe from this group and stop receiving emails from it, send an email to clojure-power+unsubscr...@googlegroups.com. To post to this group, send email to clojure-po...@googlegroups.com. Visit this group at http://groups.google.com/group/clojure-power?hl=en. For more options, visit https://groups.google.com/groups/opt_out. -- -- 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/groups/opt_out.
Re: [clj-power] Improving visibility of clojure-doc.org
I added a link to http://clojure-doc.org in both the group discussion and the about page for the Den of Clojure (http://www.meetup.com/denofclojure/). Sean (or anyone else for that matter) is there an easy way we can let the rest of the user group to lend a hand? Is there a better place to post the link on the meetup site? Daniel On Wednesday, February 27, 2013 12:55:09 PM UTC-7, Alex Miller wrote: I've updated http://clojure.org/documentation to add a link to http://clojure-doc.org. I think it's a great resource for all Clojure developers!! I think it would be useful in your regular updates to highlight areas that could use help. Another area that I think would be useful in addition to the current docs are smallish examples of full projects that highlight how to put the existing pieces together into a (small) real project. Alex On Wed, Feb 27, 2013 at 12:06 PM, Michael Klishin michael@gmail.comjavascript: wrote: Started in October 2012, http://clojure-doc.org is a pretty extensive community documentation effort. It covers Clojure, its ecosystem and tools and has two key goals: * We produce beginner-friendly content * It is dead easy to join and help Even though recently that hasn't been as much activity as in the past, it is not abandoned and continues to accumulate useful, beginner-friendly material. We constantly get praises from newcomers to Clojure who discover clojure-doc.org. Unfortunately, it does not appear even in top 10 in Google for clojure docs or clojure documentation and many community members are not aware of it. In part it is less visible because we no longer actively post progress reports. Things have settled down and most of changes now are small edits and improvements all over the place. It is a bit pointless to post progress reports more often than once a month or so. So I'd like to start a discussion about what can be done about it. The community (we have 40 contributors) has worked very hard on clojure-doc.org and I'd like to see high profile resources (namly clojure.org and leiningen.org) link to it. What would it take to convince clojure.org maintainers to do so? There are still guides left ot be written (macros, gen-class), but overall, I'd say there is no better source of freely available, beginner-friendly, hackable (no Clojure CA, everything is developed on GitHub [1], content is in Markdown) documentation. All it needs is some linking and promotion love. One way to help would be to start a campaign such as Mozilla's Promote JS [docs]. Unfortunately, unlike Mozilla key contributors behind clojure-doc.org largely lack graphic and Web design skills, so replicating that campaing is probably not an option. Do you have any ideas about how we can make clojure-doc.org more visible? Do you know who can help with getting a link from clojure.org? Do you think clojure-doc.org is not good enough to be the blessed open source documentation resource? Please post your suggestions and concerns. Improving CDS visibility will benefit the entire community plus all the people who will join it in the future. Most of the work is already done, it just needs to be promoted better. Thanks you. 1. https://github.com/clojuredocs/cds -- MK http://github.com/michaelklishin http://twitter.com/michaelklishin -- You received this message because you are subscribed to the Google Groups clojure-power group. To unsubscribe from this group and stop receiving emails from it, send an email to clojure-powe...@googlegroups.com javascript:. To post to this group, send email to clojur...@googlegroups.comjavascript: . Visit this group at http://groups.google.com/group/clojure-power?hl=en. For more options, visit https://groups.google.com/groups/opt_out. -- -- 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/groups/opt_out.
