-----BEGIN PGP SIGNED MESSAGE----- Hash: SHA512 On Tue, Nov 12, 2013 at 07:30:59AM -0700, Pete Travis wrote: > 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. 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. > 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. 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. - -- Eric - -------------------------------------------------- Eric "Sparks" Christensen Fedora Project sparks@xxxxxxxxxxxxxxxxx - sparks@xxxxxxxxxx 097C 82C3 52DF C64A 50C2 E3A3 8076 ABDE 024B B3D1 - -------------------------------------------------- -----BEGIN PGP SIGNATURE----- Version: GnuPG v1.4.14 (GNU/Linux) iQGcBAEBCgAGBQJSgkBHAAoJEB/kgVGp2CYvaUcL/0fUTtU1rDTeiya9OQ+1i9Aj BSZQmyZT3cWmYql6eGb4ZLRykouiz68jNjug+h38jJeYy0i/ModWv2AEi0xYK0sW 3DXc8KRB1TwHFbNycLYWvHjM4N0slzuqReguU/vEn4Fo4TZrihHIr/XBZ+FTfOIu AQ8HW33GYw3kFeyJ9apqM+K/yGyLl4OATaqfTwZ0xXrZYD9SG7Sz6Ihc454lxleJ FDXhAyKPJJ/w2AIFCrwjy+hm9ILQfu1olmx39oeS80uiGxzXQR/2uTxzyxkTWeNH E3FK6rTFuzr+SlFRxRxbGWKXOMZNxy6eosP0K/XijFb8QLvw2rPBGFm99k+9cXt0 HlODYUvgAPFATZgW+w96RKyBGZp21qN7WF5UW3Bm3RrqDTdC35I8C8/bgfHptJ4K FcIvA1sJEyvrUy2AN7xlcO5bzEJ2iNJAgBrj2Pu1whRhBsfJTmOEW8p12mD97HYL eIeEodGrB7/evJkXEP3ITdrLuVqVHkPGgFmtI2djYQ== =EGMR -----END PGP SIGNATURE----- -- docs mailing list docs@xxxxxxxxxxxxxxxxxxxxxxx To unsubscribe: https://admin.fedoraproject.org/mailman/listinfo/docs
