On Thursday, December 5, 2013 5:35:13 PM UTC-8, Philip Brown wrote:
>
>
> Summary:
>
> (We dont need to improve our public documentation, because people can go
> BUY documentation for puppet)
>
> I can understand changing it to low priority or something.
> But *Rejecting* this issue?
>
>
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/81075a71-bff4-4efd-ae48-7ac60e723a07%40googlegroups.com.
For more options, visit https://groups.google.com/groups/opt_out.
