On Tue, Nov 12, 2013 at 9:50 AM, Eric H. Christensen <sparks@xxxxxxxxxxxxxxxxx> wrote:
-----BEGIN PGP SIGNED MESSAGE-----
Hash: SHA512
On Tue, Nov 12, 2013 at 07:30:59AM -0700, Pete Travis wrote:Where would these articles exist? Would we have docs.fp.o, the wiki, and another place for documentation? Since we don't have a good search solution I suspect that adding more locations wouldn't make it easier for people to find stuff.
> I'm not at all proposing a migration or replacement of docs.fp.o or the
> publican platform that lives there. It does its job well. I'm thinking
> of second subdomain maintained by the docs group, with only small
> articles. The kind of stuff that's lost on the wiki or in blog posts
> now, because it doesn't fit into a guide. I agree that DocBook is
> superior markup, but there are other considerations. Publican based
> sites don't scale well for a large number of articles.
I think you hit the issue here. The wiki *should* be the proper location for this kind of information, but do to the current state of the wiki this good tutorials are lots in a sea of other information. If I recall correctly fedoramagazine.org was intended to have a section for tutorials, but I don't think that ever got off the ground.
If people aren't interested in how we do things here then I'm not sure that there's much of a way to fix that. We use tried and true methods for getting the bits into the hands of the consumer. We've been through a lot of fail to get to where we are today. That's not to say there isn't room for improvement but I wonder if working on the education side of the house wouldn't be a good use of our time. Perhaps I can put together a video on creating a Publican document and doing some simple markup in DocBookXML.
> Frankly, I want this to me different enough from business as usual to
> attract people that may have already said "Oh, I looked into
> participating in Docs, and I'm not interested in how they do things." I
> envision that by providing an easy opportunity to contribute content and
> get it published, we'll both serve our users better AND we'll have a
> source of content for Guides, just waiting for more thorough markup. We
> can educate people about the benefits of docbook, but we don't have a
> captive audience - they have to come to us first.
- -- Eric
I agree that DocBook is the best format for guides and long form documentation, but I think there is value in having a way for people to help without having learn Docs processes. In my opinion the issue is that the Fedora Docs team work in a very different way when compared to other distributions. Are focus has always been on the guides that are in docs.fp.o, and we don't do much in the way for wiki based tutorials. If you look at Arch Linux as an example of the other side of the fence, they are focused on providing are large amount of information on many topics via their wiki. I think the guides are important and don't think it would be advantage to move away from that model, but giving people a means of communicating smaller bits of information more efficiently is a good thing. Maybe adding a section to the wiki menu for tutorials would help (and finally fixing the search issues), but I don't know.
-- docs mailing list docs@xxxxxxxxxxxxxxxxxxxxxxx To unsubscribe: https://admin.fedoraproject.org/mailman/listinfo/docs
