headers
John Gabriele | 7 Sep 2006 21:30
Picon

possibly helpful tweaks to the docs

Hi,

I'm just learning my way 'round Rake, and I'm grateful for the great
docs available. That said, here's my 2 cents on some small changes
that might be made to the docs at http://rake.rubyforge.org/ that I
think would make them even more helpful:

* Add "target" to doc/glossary.rdoc

* Possibly rename doc/rational.rdoc to doc/rationale.rdoc

* Not sure my guess is right here, but, in that rationale doc, add the
date it was written, and note at the top that the doc is historical
and many improvements have been made to Rake since then.

* doc/proto_rake.rdoc is a mostly empty page. You might either add the
code to it, or else remove it.

* in doc/rakefile.rdoc:

    * Under "Tasks with Prerequisites", you might mention again that
prereq's are themselves tasks too. Also, I'm guessing the prereq's and
handled in the order they're listed (left-to-right) -- if that's the
case, you might explicitly say so here.

    * Also under Tasks, you might tell the reader about the default
task, and how they'd know what the default task for their rakefile
*is* (and how they'd set the default task).

    * The 2nd paragraph under "Importing Dependencies" may be
(Continue reading)

Permalink | Reply | 0 comments |
headers
John Clayton | 28 Sep 2006 00:18

Re-rooting a directory tree for use with package task

Hi,

Let's say I have two source trees in a project, source1 and source2.   
Let's also say I want to create two packages when packing up the app  
for distribution, one from each tree.  So, I'd like to create one  
package with just the files under source1 and another with just the  
files in source2.

What I'd like:

source1
  | - file1
    - file2
    - file3
source2
  | - file1
    - file2
    - file3
pkg
  | - SuperApp-component1
     | - file1
       - file2
       - file3
  | - SuperApp-component2
     | - file1
       - file2
       - file3

What I get:
(Continue reading)

Permalink | Reply | 0 comments |

Gmane