On 12/22/2010 05:28 PM, Nigel Kersten wrote:
> On Wed, Dec 22, 2010 at 7:54 AM, Disconnect <dc.disconn...@gmail.com> wrote:
>> Wait, lets see if I understand the requirements for a 5 word addition to the
>> documentation, from a user who doesn't already use git:
>> 1: go to the page below
>> 2: discover it requires git
>> 3: figure out what git is
>> 4: install a git client
>> 5: figure out how to use same
>> 6: clone the entire repo (I just cloned it, and it weighs in at 13 megs of
>> download, 25 megs of storage)
>> 7: make the change
>> 8: Oops, the page finally links to the docs we needed at step 3 and 5. So
>> now watch a bunch of screencasts.
>> 9: Generate patches. (Fortunately, we just spent an hour watching
>> screencasts. This should be reasonably easy.)
>> 10: Open a ticket. Wait, gotta register with redmine.
>> 11: Register with bug tracker
>> 12: Create a ticket and attach the patch
>>
>> Doesn't that seem .. I dunno.. insanely bad?
> 
> Don't you think documentation deserves version control?
> 
> We accept many changes where people don't want to go through the
> overhead of supplying the patch themselves.
> 
> If they do go to this extra effort for the project however, it's
> greatly appreciated.

Ah, but the current "contributing" document lets git appear mandatory
(observe the last paragraph, esp. point (3) of the ticket requirements).

I think I shall submit a documentation bug about this ;-)

Cheers,
Felix

-- 
You received this message because you are subscribed to the Google Groups 
"Puppet Users" group.
To post to this group, send email to puppet-us...@googlegroups.com.
To unsubscribe from this group, send email to 
puppet-users+unsubscr...@googlegroups.com.
For more options, visit this group at 
http://groups.google.com/group/puppet-users?hl=en.

Reply via email to