New location for clojure-contrib autodoc
Posted by tomfaulhaber on 2009-06-14 01:37
I've been thinking about the options for moving the autodoc robot into our new world. My ideas are like this:
- Leave it at google code. Seems wrong.
- Use the assembla wiki. Doesn't seem possible programmatically .
- Use the clojure-contrib project wiki on github. Also not possible programmatically.
- Use github 'project pages.' Looks pretty reasonable.
- Do something else (privately hosted website, clojure site, etc.). Hmmm, harder and maybe more obscure.
Right now, I'm leaning towards github project pages. This would give us a site at http://richhickey.github.com/clojure-contrib that would be a flexible http site that we could use to stash docs. Info is here http://github.com/blog/272-github-pages and here http://pages.github.com/.
Does my thinking seem right?
That led me to another idea: perhaps instead of clojure and clojure-contrib's master repositories living under "richhickey," Rich should make a new github account called 'clojure'. Then the repositories would be at github.com/clojure/clojure{,-contrib}, Rich could add more 'official' Clojure projects there, and we could use the github pages clojure.github.com, clojure.github.com/clojure, clojure.github.com/clojure-contrib, etc. for anything that made sense.
Rich could then use the 'richhickey' account for unofficial things like sdb and there'd be no confusion.
In any case, that's up to you, Rich. Just sharing what's bubbling around in my brain.
Tom
- Leave it at google code. Seems wrong.
- Use the assembla wiki. Doesn't seem possible programmatically .
- Use the clojure-contrib project wiki on github. Also not possible programmatically.
- Use github 'project pages.' Looks pretty reasonable.
- Do something else (privately hosted website, clojure site, etc.). Hmmm, harder and maybe more obscure.
Right now, I'm leaning towards github project pages. This would give us a site at http://richhickey.github.com/clojure-contrib that would be a flexible http site that we could use to stash docs. Info is here http://github.com/blog/272-github-pages and here http://pages.github.com/.
Does my thinking seem right?
That led me to another idea: perhaps instead of clojure and clojure-contrib's master repositories living under "richhickey," Rich should make a new github account called 'clojure'. Then the repositories would be at github.com/clojure/clojure{,-contrib}, Rich could add more 'official' Clojure projects there, and we could use the github pages clojure.github.com, clojure.github.com/clojure, clojure.github.com/clojure-contrib, etc. for anything that made sense.
Rich could then use the 'richhickey' account for unofficial things like sdb and there'd be no confusion.
In any case, that's up to you, Rich. Just sharing what's bubbling around in my brain.
Tom
Home / Developer API / Tour / Get a Project - Solutions for Bug & Issue Tracking, Collaboration Tools, Subversion Hosting, Git Hosting
Clojure contrib is powered by Assembla.
1 Comments
By tomfaulhaber on 2009-06-15 03:52
This is exactly what Rails does, fwiw. There is a github account http://github.com/rails and it has a project (among many, actually) called rails. So the Rails code is at http://github.com/rails/rails.
They're not using github pages, though.