I think it should be documented, maybe not on guides but somewhere. I've opened a issue about a similar subject in the past assuming that was a bug instead of the expected behavior.
Note that I agree that's a "advanced topic" but the truth is we need to document it somewhere. I would be happy to make a blog post about this topic but posts aren't always found like the official documentation or wiki. Makes any sense to enable the GitHub wiki? The GitHub wiki will allow topics like that without making any extra effort from the rails core team who already have a lot of work :) On Friday, February 8, 2013 8:57:20 PM UTC-2, Ryan Bigg wrote: > > I agree with José. Is there a tl;dr for this thread? > > > > On 09/02/2013, at 6:35, José Valim <jose....@gmail.com <javascript:>> > wrote: > > I don't know what the fuss is about and what needs to be documented. > > Most Ruby gems (and even libs inside Ruby) require you to load the > *top-level* file in order to use it properly. > You can't go around picking whatever you want and expect it to work. > Examples: > > 1. Rake does common requires: > > https://github.com/jimweirich/rake/blob/master/lib/rake.rb > > For example, this file assumes Task is loaded: > > https://github.com/jimweirich/rake/blob/master/lib/rake/multi_task.rb > > 2. Rack sets up autoloads: > > https://github.com/rack/rack/blob/master/lib/rack.rb > > 3. Webrick does the same as Rake: > > https://github.com/ruby/ruby/blob/trunk/lib/webrick.rb > > So saying Rails is "stupid" regarding this requirement shows rather a lack > of understanding how most Ruby libraries work. > > -- > You received this message because you are subscribed to the Google Groups > "Ruby on Rails: Core" group. > To unsubscribe from this group and stop receiving emails from it, send an > email to rubyonrails-co...@googlegroups.com <javascript:>. > To post to this group, send email to rubyonra...@googlegroups.com<javascript:> > . > Visit this group at http://groups.google.com/group/rubyonrails-core?hl=en. > For more options, visit https://groups.google.com/groups/opt_out. > > > > -- You received this message because you are subscribed to the Google Groups "Ruby on Rails: Core" group. To unsubscribe from this group and stop receiving emails from it, send an email to rubyonrails-core+unsubscr...@googlegroups.com. To post to this group, send email to rubyonrails-core@googlegroups.com. Visit this group at http://groups.google.com/group/rubyonrails-core?hl=en. For more options, visit https://groups.google.com/groups/opt_out.