On Jan 29, 2014 11:56 AM, "Adam Williamson" awilliam@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