As a member of the Puppet Labs docs team, I would like to second what Nick said. We are a small team with a big backlog and we could not get our jobs done if it were not for the engagement and and assiduousness of our users. Thanks for your help and your patience.
As we grow the team and move ahead, I'll look forward to getting your comments and feedback. Fred Lifton On Friday, December 6, 2013 1:24:53 PM UTC-8, Nick Fagerlund wrote: > > > > Hi all, I'm the one who closed that ticket. Sorry, my bad. > > First off, WE STILL PLAN TO IMPROVE THE TYPE AND PROVIDER DOCS. They can & > should & will be better, and we don't consider the O'Reilly "Puppet Types > and Providers" book to be an acceptable replacement for free documentation > on our website. > > That's going to take a big chunk of time, though, and we (the Puppet Labs > docs team, hi) will have to schedule it as planned work. > > Anyway, here's what happened with that ticket: > > > - We're moving ticketing systems. The new one will be publicly visible > at tickets.puppetlabs.com in a matter of days. > - The docs team is already tracking work in the new system. We are not > tracking ANY work in Redmine. The stuff in Redmine is old and out of date. > - So now I have to do a mass cleanup on the old stuff in Redmine in > preparation for the complete switch-over. > - Some things I'm fixing now, some things I'm making new tickets > for, some things aren't relevant anymore, and some things are so > well-known > in my team that we don't really need a ticket as a reminder; instead, > we'll > be hashing them out in our planning sessions once we've dealt with the > stuff we're currently working on (at which point they'll turn into like > a > dozen related tickets). "Overhaul the type/provider docs" is in that > last > group. > - I marked some tickets as "rejected" that I should have marked as > "closed." (Since we're still planning to do the work, but we aren't > tracking it in that Redmine ticket anymore.) Sorry! > - On some of those, I also made a note or two about related > developments that may have changed the relative priority of the issue. (In > this case, the fact that there's a good reference *somewhere* out there > means we have a small bit of breathing room, even though we still need to > improve our version.) > - I *should* have also pasted in some boilerplate about WHY I was > closing 50 tickets at once, and what to do if you were following one of > them. > > > So yeah, sorry for implying we weren't going to improve type/provider > docs; that's not what I was trying to say at all. Closing that ticket was > about housekeeping, not about rejecting the work it represented. There will > be a bit of an awkward stage as we switch ticketing systems; sorry about > that, and thank you for staying vocal about what needs work. > > NF > > -- You received this message because you are subscribed to the Google Groups "Puppet Users" group. To unsubscribe from this group and stop receiving emails from it, send an email to puppet-users+unsubscr...@googlegroups.com. To view this discussion on the web visit https://groups.google.com/d/msgid/puppet-users/20738625-991e-4b8c-ba98-c0c56ebaffc1%40googlegroups.com. For more options, visit https://groups.google.com/groups/opt_out.
