# Rake doc:rails fails

**URL:** <https://www.ruby-forum.com/t/rake-doc-rails-fails/59769>\
**Category:** Rails\
**Created:** [May 6, 2006, 10:30am UTC](https://www.ruby-forum.com/t/rake-doc-rails-fails/59769 "2006-05-06T10:30:01Z")\
**Posts on this page:** 5\
**Page:** 1

<div class="post-metadata">

**Author:** ![regularfry](https://www.ruby-forum.com/letter_avatar_proxy/v4/letter/r/45deac/32.png) [@regularfry](https://www.ruby-forum.com/u/regularfry)\
**Post date:** [May 6, 2006, 10:30am UTC](https://www.ruby-forum.com/t/rake-doc-rails-fails/59769/1 "2006-05-06T10:30:01Z")

</div>

Hi there,

Running doc:rails and doc:rerails on a fresh rails directory after  
running ‘rake freeze\_gems’ fail with the following error:

> Don’t know how to build task ‘vendor/rails/activesupport/README’

Should it work? That file doesn’t seem to exist.

If that’s not the sequence for generating the api documentation, what  
should it be?

---

<div class="post-metadata">

**Author:** ![regularfry](https://www.ruby-forum.com/letter_avatar_proxy/v4/letter/r/45deac/32.png) [@regularfry](https://www.ruby-forum.com/u/regularfry)\
**Post date:** [May 6, 2006, 12:51pm UTC](https://www.ruby-forum.com/t/rake-doc-rails-fails/59769/2 "2006-05-06T12:51:08Z")

</div>

I’m a noob, so don’t take my answer as final, but I use ‘rake appdoc’  
successfully.

---

<div class="post-metadata">

**Author:** ![regularfry](https://www.ruby-forum.com/letter_avatar_proxy/v4/letter/r/45deac/32.png) [@regularfry](https://www.ruby-forum.com/u/regularfry)\
**Post date:** [May 6, 2006, 1:07pm UTC](https://www.ruby-forum.com/t/rake-doc-rails-fails/59769/3 "2006-05-06T13:07:37Z")

</div>

Damien T. wrote:

> I’m a noob, so don’t take my answer as final, but I use ‘rake appdoc’  
> successfully.

That generates the documentation for a given application. I want the  
API docs, as presented at [http://api.rubyonrails.org](http://api.rubyonrails.org). rake -T lists  
rake doc:rails and rake doc:rerails as options, but neither of them  
works - at least, not the way I’m expecting, which may well be wrong.

This is rails 1.1.2 on Ruby 1.8.4.

---

<div class="post-metadata">

**Author:** ![regularfry](https://www.ruby-forum.com/letter_avatar_proxy/v4/letter/r/45deac/32.png) [@regularfry](https://www.ruby-forum.com/u/regularfry)\
**Post date:** [May 6, 2006, 3:41pm UTC](https://www.ruby-forum.com/t/rake-doc-rails-fails/59769/4 "2006-05-06T15:41:43Z")

</div>

* * *

Rails mailing list  
removed\_email\_address@domain.invalid  
[http://lists.rubyonrails.org/mailman/listinfo/rails](http://lists.rubyonrails.org/mailman/listinfo/rails)

---

<div class="post-metadata">

**Author:** ![regularfry](https://www.ruby-forum.com/letter_avatar_proxy/v4/letter/r/45deac/32.png) [@regularfry](https://www.ruby-forum.com/u/regularfry)\
**Post date:** [May 7, 2006, 10:17am UTC](https://www.ruby-forum.com/t/rake-doc-rails-fails/59769/5 "2006-05-07T10:17:31Z")

</div>

Dave T. wrote:

> I mentioned this to the team when I was writing about generating  
> documentation for the book, and the next release will include the README  
> in the Gem. In the meantime, creating a dummy file allows the  
> documentation to proceed.

Excellent. Thanks for that.