Re: [Puppet-dev] Re: Replacement for puppet doc

2014-08-13 Thread Hailee Kenney
On Wed, Aug 13, 2014 at 7:51 AM, Daniele Sluijters < daniele.sluijt...@gmail.com> wrote: > What Nick, Henrik and Erik said. Rename the old tool, deprecate it and > remove it. `puppet doc` is the command that makes sense and that sensible > command should do sensible things. > > I kinda do like 'co

Re: [Puppet-dev] Re: Replacement for puppet doc

2014-08-13 Thread Daniele Sluijters
What Nick, Henrik and Erik said. Rename the old tool, deprecate it and remove it. `puppet doc` is the command that makes sense and that sensible command should do sensible things. I kinda do like 'codex' though, it has a ring to it. -- Daniele Sluijters On Tuesday, 12 August 2014 23:52:39 UTC

Re: [Puppet-dev] Re: Replacement for puppet doc

2014-08-13 Thread Craig Dunn
On Wed, Aug 13, 2014 at 5:55 AM, Wil Cooley wrote: > > On Aug 12, 2014 1:00 PM, "Daniele Sluijters" > wrote: > > > > Please don't use `dox`. It's like a teenager who wasn't taught enough > English in school, or simply doesn't care, to know that the accepted plural > of doc is docs, not dox, dawg

Re: [Puppet-dev] Re: Replacement for puppet doc

2014-08-12 Thread Wil Cooley
On Aug 12, 2014 1:00 PM, "Daniele Sluijters" wrote: > > Please don't use `dox`. It's like a teenager who wasn't taught enough English in school, or simply doesn't care, to know that the accepted plural of doc is docs, not dox, dawg. I have to agree, if for a different reason -- "dox" has taken on

[Puppet-dev] Re: Replacement for puppet doc

2014-08-12 Thread Henrik Lindberg
On 2014-12-08 23:52, Nick Fagerlund wrote: Well, something I've learned over the last four years is that cute names age a lot faster than you'd think. So I'm generally in favor of descriptive ones instead, at least when we're dealing with command -line tools. And unfortunately, "puppet doc" is p

Re: [Puppet-dev] Re: Replacement for puppet doc

2014-08-12 Thread Nick Fagerlund
Well, something I've learned over the last four years is that cute names age a lot faster than you'd think. So I'm generally in favor of descriptive ones instead, at least when we're dealing with command -line tools. And unfortunately, "puppet doc" is pretty much the perfect name for it. :/ So

Re: [Puppet-dev] Re: Replacement for puppet doc

2014-08-12 Thread Daniele Sluijters
Please don't use `dox`. It's like a teenager who wasn't taught enough English in school, or simply doesn't care, to know that the accepted plural of doc is docs, not dox, dawg. On Tuesday, 12 August 2014 19:33:04 UTC+2, Andy Parker wrote: > > On Tue, Aug 12, 2014 at 10:19 AM, Hailee Kenney > wr

Re: [Puppet-dev] Re: Replacement for puppet doc

2014-08-12 Thread Andy Parker
On Tue, Aug 12, 2014 at 10:19 AM, Hailee Kenney wrote: > > Thanks for all the feedback everyone! Going back to the issue of naming, I > have a list of suggestions I've collected that I wanted throw out there for > discussion: > > puppet strings (this seems to be a popular choice) > I like this o

Re: [Puppet-dev] Re: Replacement for puppet doc

2014-08-12 Thread Hailee Kenney
On Sat, Aug 9, 2014 at 1:29 PM, Henrik Lindberg < henrik.lindb...@cloudsmith.com> wrote: > On 2014-09-08 20:32, Wil Cooley wrote: > >> On Aug 8, 2014 5:15 PM, "Hailee Kenney" > > wrote: >> > >> > Right now, Charlie Sharpsteen has an awesome prototype which uses >> Y

[Puppet-dev] Re: Replacement for puppet doc

2014-08-09 Thread Henrik Lindberg
On 2014-09-08 20:32, Wil Cooley wrote: On Aug 8, 2014 5:15 PM, "Hailee Kenney" mailto:hai...@puppetlabs.com>> wrote: > > Right now, Charlie Sharpsteen has an awesome prototype which uses YARDoc instead of RDoc. I see that "YARD does not impose a specific markup"[1] and I cannot tell from Charl