fix instructions for contributing to lib.d.ts

[sparecycles]

@mhegazy

[sparecycles]

Tried running jake lib in the #5461 commit, didn't work then either 😉

[mhegazy]

no, it is lib that builds the library files.

jake lib -> src\lib\*.d.ts combine them into built\local\lib.*.d.ts
jake LKG -> jake local with debug=false, copy built\local\* to lib\* in preparation of publishing an npm

so files in \lib\ should not be touched by hand, only through jake LKG

[mhegazy]

Tried running jake lib in the #5461 commit, didn't work then either 😉

how is that? what did you see? any errors?

[sparecycles]

You don't even need jake lib to update the built/local data, just running jake after changing src/lib files updates that fine (as I expect running jake with no arguments to do).

But, when I run jake lib I don't think it's out of scope to assume lib would be updated.

In the instructions: "To build the library files" obviously means the files in lib/ (except it doesn't). The README in lib/ says these files are not meant to be updated by hand, and changes should be made in src/ but nowhere is it documented that the command is jake LKG.

Can you not see how this is confusing?

[mhegazy]

i see. well in my defense, \lib was called \bin and that was less confusing..

Any how, so we can make it jake local or just 'jake`, how about that?

[sparecycles]

(hmm... musing) perhaps /bootstrap ( or /bs ? ) would be a better name?

[mhegazy]

looks good. thanks!