Re: ANN How To Make Your Open Source Project Awesome (or: Not Suck)
"In explaining Clojure, for example, you'll find that the motivations are usually brought forth in a Rich Hickey talk. He talks about the motivations for immutable data structures, for time and state, for carrying metadata, and so much more. None of this is in the code base. " I can sympathize with this point of view. I also think that Github wikis are a double-edged sword. They're convenient when you're exploring the repository in your browser, and a pain when you're not. It believe it would be a great first step to take the content from the Clojure website (where Rich has explained immutability, state, persistent data structures, etc) and store them as some variant of plain text (org mode?) in the repo itself. This is precisely the approach taken by git, for instance. In its Documentation folder you can find not only "man page" style docs, but also docs explaining data structures, motivations, things only contributors need to care about and so on. Tools can the process these files as well and make websites or wikis out of them. This is not quite the same as literate programming, obviously, but it seems to me to be an easily achievable first step for any project, including Clojure core, with potential benefits that surpass the effort required to make it happen. P.S. Sorry if the quoting is off...typing from a phone. -- -- 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: [ANN] Pedestal docs are now open-source
Thanks for everything. Cheers, tony On Sat, Apr 20, 2013 at 6:25 AM, Michael Klishin < michael.s.klis...@gmail.com> wrote: > 2013/4/20 Ryan Neufeld > >> Find more details on making contributions in our contribution guidelines >> here: https://github.com/pedestal/docs/blob/master/CONTRIBUTING.md >> >> Happy Hacking, >> Ryan @ Relevance >> > > Ryan, > > I'd like to thank everyone at Relevance for making this happen. > The "we accept minor corrections without CA on file" policy is great. > -- > 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. > > > -- Antoine R. Dumont happy hacker https://github.com/ardumont https://coderwall.com/ardumont http://twitter.com/ardumont -- -- 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.
[ANN] ClojureC 0.1
Dear Clojurians, I'm happy to announce ClojureC 0.1: https://github.com/schani/clojurec ClojureC is a Clojure to C compiler that's based off of ClojureScript. It's still in its infancy, not ready for real use, but at this point almost all of ClojureScript's core library has been ported - most of it without needing any modification. If you're interested in contributing, here are a few things we need to make ClojureC useful, in order of difficulty: * Regular expressions - probably by binding PCRE or something similar. * I/O of all kinds - file, network * A somewhat generic method for binding C libraries * A debugger * Better generated C code - right now it's very inefficient, but there's lots of low-hanging fruit. Cheers! Mark -- -- 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.