Rails guides build problems: again!

rubyonrails-docs
1

Maybe we should consider including the guides generation to the continuous integration server.

Every time I try to build the guides from master branch I have problems... These are the error messages this time:

rake doc:guides --trace

(in /home/rodrigo/temp/rails/ validations_teste) ** Invoke doc:guides (first_time) ** Execute doc:guides Generating 2_3_release_notes rake aborted! undefined method `keys' for nil:NilClass In /home/rodrigo/temp/rails/validations_teste/vendor/rails/railties/ guides/source/layout.html.erb

    /usr/lib/ruby/1.8/rake.rb:636:in `call'     /usr/lib/ruby/1.8/rake.rb:636:in `execute'     /usr/lib/ruby/1.8/rake.rb:631:in `each'     /usr/lib/ruby/1.8/rake.rb:631:in `execute'     /usr/lib/ruby/1.8/rake.rb:597:in `invoke_with_call_chain'     /usr/lib/ruby/1.8/monitor.rb:242:in `synchronize'     /usr/lib/ruby/1.8/rake.rb:590:in `invoke_with_call_chain'     /usr/lib/ruby/1.8/rake.rb:583:in `invoke'     /usr/lib/ruby/1.8/rake.rb:2051:in `invoke_task'     /usr/lib/ruby/1.8/rake.rb:2029:in `top_level'     /usr/lib/ruby/1.8/rake.rb:2029:in `each'     /usr/lib/ruby/1.8/rake.rb:2029:in `top_level'     /usr/lib/ruby/1.8/rake.rb:2068:in `standard_exception_handling'     /usr/lib/ruby/1.8/rake.rb:2023:in `top_level'     /usr/lib/ruby/1.8/rake.rb:2001:in `run'     /usr/lib/ruby/1.8/rake.rb:2068:in `standard_exception_handling'     /usr/lib/ruby/1.8/rake.rb:1998:in `run'     /usr/bin/rake:28

Could someone help me getting these guides to build?

2

After a certain commit in rails master guides were broken in two ways:

One way is that error you got. There's a workaround in docrails for that. As a temporary solution please generate them in docrails a docrails checkout.

Second issue is that something related to content_for breaks generation in a way that, well, something is generated and is kinda readable, but design is broken. Yehuda is having a loot at that.

3

Maybe we should consider including the guides generation to the continuous integration server.

Every time I try to build the guides from master branch I have problems... These are the error messages this time:       After a certain commit in rails master guides were broken in two ways:

One way is that error you got. There's a workaround in docrails for that. As a temporary solution please generate them in docrails a docrails checkout.    

Thank you Xavier, I'll do that.

Second issue is that something related to content_for breaks generation in a way that, well, something is generated and is kinda readable, but design is broken. Yehuda is having a loot at that.     Good. Are there any plans to include the guides build process into the continuous integration server? Maybe the documentation to "Contributing to Rails" could mention that they should build the guides too, besides running the tests. Or maybe implementing a test for testing if the guides are being generated... This would avoid this issue from time to time.

Best Regards,

Rodrigo.