From: Zachary Scott <e@...>
Date: 2014-09-09T13:18:16-07:00
Subject: [ruby-core:64905] Re: documenting constants

I think it should go in one of two places:

./doc/syntax/constants.rdoc or ./doc/constants.rdoc

It depends on whether you consider constants a language feature or a
syntax feature, or if there is any real difference there.

Personally, putting it under syntax keeps the ./doc much cleaner, but
we can always worry about that later.


Thank you for working on this! Xavier is my hero <3 <3 <3 <3 <3 <3 <3

On Sun, Sep 7, 2014 at 10:02 PM, Xavier Noria <fxn@hashref.com> wrote:
> On Mon, Sep 8, 2014 at 1:22 AM, Eric Wong <normalperson@yhbt.net> wrote:
>
>> We already have syntax.rdoc, keywords.rdoc, globals.rdoc files in the
>> doc/ directory for general "man 7"-type things which do not fit into
>> a traditional module/class/method/API category.
>>
>> So I think doc/constants.rdoc would be a good place for this.
>
> That place seems perfect, awesome Eric!
>
>> Eric Hodel and Zachary Scott would be the best folks to comment, though.
>
> Cool, let's see what they think.