On 07/19/11 - 05:44:28PM, Matt Wagner wrote:
On Tue, Jul 19, 2011 at 02:11:26PM -0400, Hugh Brock wrote:
> Below are some obvious buckets, please feel free to suggest additional
> features large or small.
I'd really love it if "Documentation" were on this list. It's not
really
a task as much as an ongoing process that we could improve on.
I'm very specifically *not* requesting that Justin be asked to write
documentation that's meticulously-proofread, peer-reviewed, and
QE-tested on multile platforms for the main website. (Although that'd be
a nice eventual goal.)
Instead, I really like the idea of throwing wiki pages together as we
go. They'll surely start off mediocre, but that's infinitely better (in
my mind, at least) than documentation that's yet to be written. As we
go, we can fill in holes, clean up errors, and generally enhance it.
Whether the wiki is the permanent home or we eventually move it to the
main website doesn't really matter to me. I just want it to exist.
Absolutely. We should be doing this all of the time. Stuff that ends up
being immensely useful can eventually get graduated to the main website, or
man pages, or whatever, but this sort of thing is essential to making this
useful to outside people.
--
Chris Lalancette