On Jan 29, 2014 11:56 AM, "Adam Williamson" <awilliam(a)redhat.com> wrote:
On Wed, 2014-01-29 at 11:33 -0700, Pete Travis wrote:
> There's a wiki page with comparable content that some prefer to
> reference; I'm continually tempted to purge such things and replace
> them with a redirect, but that's a different story...
I don't like the duplication either, but tbh since it's nice and easy to
edit the wiki, that tends to be more accurate and up to date than the
installation guide at any given time :/ often I find myself throwing in
updates to the USB instructions at the hairy end of a release cycle, and
it's much easier to edit a wiki to do that than jump through the hoops
to edit the installation guide.
--
Adam Williamson
Fedora QA Community Monkey
IRC: adamw | Twitter: AdamW_Fedora | XMPP: adamw AT happyassassin . net
http://www.happyassassin.net
--
"readme-burning-isos" is more targeted than the Installation Guide, but
yeah, the same hoops. After that, it is more or a circuitous problem; wiki
gets more attention because it is more up to date...
This page and others are on my watchlist for this reason and I generally at
least attempt to sync over your edits. There's duplication, and then
there's a situation where someone works on a problem, you discover the work
doing QA, I find out about the work by stumbling onto a wiki edit or list
discussion, then update the Guide. I pipe up whenever someone brings up
"improved documentation" because it isn't clear *what* is being referred to
- wiki, manpage, blog post, whatever - and bugs against guides or some
other form of direct contact with the docs team are a very rare result.
--Pete