aperture science wrote:
> I have been trying for a few days to set up a basic user registration/
> login system with rails 3 and nearly every single piece of
> documentation is outdated. 

This is not uncommon on the open source. With the vast number of changes 
from Rails 2.x to Rails 3.0 It's my feeling the community has done an 
outstanding job of updating the critical documentation. Of course the 
conversion isn't complete, but I think your 90% figure is far to high.

> Restful_authentication has several git
> branches, none of which appear to result in a working installation.
> All of them leave me with "could not find generator authenticated".

I would highly recommend against restful_authentication. Most Rails 
developers have moved to the better solutions like Devise and Authlogic.

> With Devise: "could not find generator devise"  Which I only got
> slightly installed after finding some guy's blog entry on the subject.

I'm not sure about Devise, I've started implementing in Rails 3 and had 
no problem running the generator with the documented Rails 3 command:

rails generate devise:install

Are you sure that your Rails 3 environment, and Ruby, is installed and 
configured properly?
What platform are you using? (Operating system, Ruby version, RVM, etc)

> authlogic finally got installed and I could generate some models but
> the documentation broke down when the singular guide I could find for
> rails 3 was unable to account for an uninitialized constant
> userSessionController.  I could not find much of any documentation on
> the general "uninitialized constant" error anywhere.

I've not tried Authlogic. However unless "userSessionController" is just 
a typo in this forum post I can certainly see why you would get an 
"uninitialized constant" error since class names should be upper camel 
case (e.g. UserSessionController). That's basic Ruby and has nothing to 
do with poor documentation on the part of Rails or Authlogic.

> I still see most references saying to use "script/*" method.

Why is that a big deal? Rails 3 documentation 
(http://guides.rubyonrails.org/command_line.html) clearly states the 
usage of the new commands (e.g. rails generate (g), rails server (s), 
etc.).

> Am I better off downgrading to some old version of rails? Or have I
> just been horribly wrong in everything?

I'd say no. For anyone starting out with Rails I'd recommend learning 
Rails 3.

Given this stuff is all open source I'd say to start getting used to 
figuring things out for yourself. This is a community effort. Most 
people working on Rails have other jobs as well. Documentation is 
"owned" by the community. Rather than complain about the documentation 
start contributing to fix it. If you find something wrong fix it and 
submit it. I'm sure the Rails team would appreciate such contributions.

> I would really like to use rails for my projects, but it seems as
> though there is no unification in the project.  Nothing works together
> from moment to moment, and updates seem to break every thing.  If
> rails 3 is too new, what is the recommended rails version with
> compatibility with plugins in mind?  Or can anyone suggest a
> registration/authentication framework/plugin for rails 3 that has
> concise clear and functional documentation that isn't fragmented and
> pieced together from semi-working examples taken from blog sites?

I have, so far, not run into any of the issues you've mentioned with my 
experimentation with Devise. I found their documentation to be clear, 
concise and accurate. I think you have some other problems with your 
setup.
-- 
Posted via http://www.ruby-forum.com/.

-- 
You received this message because you are subscribed to the Google Groups "Ruby 
on Rails: Talk" 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-talk?hl=en.

Reply via email to