November is docs month
Posted by
Tom | September 24, 2007 12 Responses comments

So after highlighting the fact that documentation is now soooo important, you must all be thinking “OK, so…?”. The current situation is this. The Hobo team is getting towards the end of a large development project, and all going well we should have a decent chunk of time to give Hobo some TLC in November. So, no guarantees, but you can look forward to a much higher level of docs, and maybe even some shiny new screencasts towards the end of November.

Reader Comments Add your comment »

Cool. I saw your talk at RailsConf and I’m very interested in checking it out.

Nice! I’m looking forward to the new documentation.

I’ve recently upgraded a project to the latest hobo and whew… it was a task.

Fortunately all the browsing of the hobo source that was necessary has made me a better programmer and I have learnt far more about several technologies than I would have were the process simpler. ;)

Tom, I think this is a great idea! I’m looking forward to getting back to working with hobo after half a year’s hiatus.. I think it would be really helpful for novices if there was a ‘getting started’ doc which covered how to get started with the new bits and then one can go from there and read the source.. (nothing beats the docs, but a new up-to date getting started with the latest version would go a long way.)

thanks for sharing your hard work with the rest of us and also for posting the slides, I hope the conference folks post the videos/audios soon.. lots of good talks happened there it seems..

Tom, thats great to hear!
I’m really looking forward to the docs (I think docs are far more important than screencasts – at least until the docs are at a usable level). I hope I can use Hobo in one of my next projects.
Great work, great talk at railsconf and it was a pleasure talking to you wednesday morning

I wrote a simple little getting started with hobo here

http://sublimeguile.com/2007/09/25/getting-started-with-hobo/

exactly because the screencasts were out of date. I know that all the docs are important — I’m planning on writing up more tutorials to help me figure things out. But I would just like to vote for a pushing up a new screen cast in the schedule of the things. The screencast give people an overview in a way that reading about it doesn’t. I think it’s easier to go from the screencast, seeing what is supposed to happen, to looking at the source to figure out the details then starting from a write up.

But that’s just my opinion.

I really like Hobo but I agree we need docs. I have some time available and would like to help in this area.

I posted in trac but there was enough spam I was concerned my note would get lost. Please let me know if you are willing to let me clean-up the spam tickets and contribute to the documentation process.

I realize that an offer like this in a blog comment is a bit strange, but I did not see a more direct method of contact. I can video chat or call to talk more about it if you like.

I am just a short time hobo fan, but i really like it. I look forward to the documentiaton. thanks

Still on for Doc Month?

I would be happy to review and comment, more as a careful reader than a Rails or Hobo expert.

Paul

Hi Tom, hope you own project is going well! Cannot wait to see the new screencasts when they arrive!

Paul – Yep still on for docs month :-)

Any feedback greatly appreciated — keep your eye on the blog for updates.

Still waiting for updated screencasts..


Write a Comment

Comments are formatted using markdown. To include code, either quote it in `backticks` or indent a code-block by 4 spaces.