On Thu, 2016-02-04 at 11:54 +0100, Paul W. Frields wrote: > Short articles and wiki pages and other similar focused docs, on the > other hand, have really eaten our lunch, as far as being the places > users go to find information. I routinely run into users who tell me > they find answers for how to do things for Fedora on StackExchange, > Arch wiki, Ubuntu forums, and so forth. The challenge with short articles is maintenance. Google anything on Fedora or Linux for that matter, and almost everything will be sadly out of date or just plain incorrect. That even applies to our own wiki, in spite of numerous attempts at wiki gardening. With a small number of documentation products, it is a lot easier to keep track of the documents and identify them as to the version they reflect. It makes me wonder whether some of the web-based git tools might help (OK, I'm a major git fanboy). Most of the public git repositories include a wiki. If we could somehow tie that wiki to branches or even tags, perhaps we could develop a more edible set of documents that would allow the user to find not only the information needed, but also for the appropriate period in history. Just noodling. (BTW, it looks like it may be a while before I can join the meetings again. This Flint water thing has me on the phone with the state emergency operations center every day at meeting time.) --McD -- docs mailing list docs@xxxxxxxxxxxxxxxxxxxxxxx To unsubscribe: http://lists.fedoraproject.org/admin/lists/docs@xxxxxxxxxxxxxxxxxxxxxxx
