Yeah, I'm really excited by the pdoc effort. (I can't say I like the syntax, but that's a massively-secondary concern.) Having the docs in the code itself is The Right Thing, IMHO, with the only downside really being that it's difficult to have docs-only committers. (It's possible, though: If a file were being checked in by a docs-only committer, an automated mechanism could strip the comments from the checked-in version and the new version and compare them, rejecting the checkin if non-doc changes were found.)
-- T.J. :-) On Jun 6, 2:41 pm, kangax <[EMAIL PROTECTED]> wrote: > Agreed. Wrong statement is worse than lack of it : ) > > The docs are not on git, afaik. > There's a new "pdoc" (inline documentation parser) in the works (by > Tobie/Andrew) - but it's not clear when it will be ready to go public. > We would all "fix" the docs errors happily, but I can hardly remember > last time documentation was updated : / > > - kangax > > On Jun 6, 8:34 am, "T.J. Crowder" <[EMAIL PROTECTED]> wrote: > > > Gah! Sorry, I should have looked. > > > FWIW, have to disagree with the low/minor categorization. It's not > > just that it doesn't say, it's that it explicitly does say the wrong > > thing... Are the docs on git? (I don't immediately see them.) I'd > > happily fix doc errors... > > -- > > T.J. Crowder > > tj / crowder software / com > > > On Jun 6, 12:54 pm, kangax <[EMAIL PROTECTED]> wrote: > > > > T.J. > > > Thanks, this has already been brought up some time > > > ago.http://dev.rubyonrails.org/ticket/10263 > > > > - kangax > > > > On Jun 6, 6:25 am, "T.J. Crowder" <[EMAIL PROTECTED]> wrote: > > > > > Hi all, > > > > > In the docs, it says that Array.indexOf uses equivalence (==), not > > > > strict equality (===). > > > > (http://www.prototypejs.org/api/array/indexof) > > > > But the code uses strict equality. From 1.6.0.2: > > > > > if (!Array.prototype.indexOf) Array.prototype.indexOf = function(item, > > > > i) { > > > > i || (i = 0); > > > > var length = this.length; > > > > if (i < 0) i = length + i; > > > > for (; i < length; i++) > > > > if (this[i] === item) return i; > > > > return -1; > > > > > }; > > > > > So I'll file a ticket, my only question is whether I should file it > > > > against the code or the docs. ;-) > > > > -- > > > > T.J. Crowder > > > > tj / crowder software / com --~--~---------~--~----~------------~-------~--~----~ You received this message because you are subscribed to the Google Groups "Prototype: Core" group. To post to this group, send email to [email protected] To unsubscribe from this group, send email to [EMAIL PROTECTED] For more options, visit this group at http://groups.google.com/group/prototype-core?hl=en -~----------~----~----~----~------~----~------~--~---
