Jay Levitt wrote: > Meh.. I'm not that impressed. For one thing, "Ubuntu LTS" is a > designation, not a version. I have Ubuntu LTS on my server - it's > Dapper. > Which LTS are they talking about? For another, why is the main menu off > to > the right instead of in front of my face? I'm not saying it's awful, > I'm > just saying it's not an archetype. > > The problem with *any* technical documentation is that every single > reader > has a different level of expertise. As you said, you "had no clue of > how > to do anything in Linux before this". If I had to read through that > level > of detail to set up Rails, I'd scream. > > OTOH, writing multiple versions means there's more information you have > to > keep in sync as Rails changes - and more work, in general. Also, geeks > suck at seeing things from the viewpoint of anyone less experienced than > they are. > > A good writer can balance all that out. So can a good editorial system > (e.g. better wiki software, which we're working on, for some value of > "we" > and "working" and "on").
There are always the 'beginner' sections of the wiki for the 'hand holding' articles. I agree the the site design isn't amazing, but the articles are quite good to help a novice. Besides, everyone is a n00b at first :P And multiple documentation sources to bring up the need to update all of them, but it's also easier to find a documentation source you like if it's in lot's of different places. I'm excited to see better wiki software happening. Especially if there will be a preview option. It would be nice to have automatic redirects and standard ways of marking/categorizing articles. Melvin Ram wrote: >>It was amazingly helpful in helping me get my server configured for >>rails. Do you use Apache and the mongrel cluster etc. on your Linux box? The Deployment HOWTO could definitely use some work once the wiki has been migrated. -- Posted via http://www.ruby-forum.com/. --~--~---------~--~----~------------~-------~--~----~ You received this message because you are subscribed to the Google Groups "Ruby on Rails: Core" group. To post to this group, send email to [email protected] To unsubscribe from this group, send email to [EMAIL PROTECTED] For more options, visit this group at http://groups.google.com/group/rubyonrails-core?hl=en -~----------~----~----~----~------~----~------~--~---
