Re: Publishing old guides

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

 



-----BEGIN PGP SIGNED MESSAGE-----
Hash: SHA1

On 04/15/2015 09:38 AM, Pete Travis wrote:
> We've talked about it a lot lately, and there's a general consensus th
at
> making room for those smaller chunks would both enable more contributo
rs
> and better target Fedora's user base.

IMO the main problem you face is the heavy start up cost for
contributing. Using git and CI is not substantially less cumbersome for
contributors than the current solution. While it may attract a few more
people like the current contributors, it won't attract new classes of
contributors.

You need to make it easy for people to contribute content, and in this
day and age that means a web interface; just one that doesn't suck.

What you need is a well curated web-based work flow.

Most wikis can handle multi-page content, that's your long articles, and
a small article is just single page.

Most wikis have a publishing process so you can vet/QA stuff before
publishing.

Most wikis have a translation work flow.

Most wikis allow you to import/cut-n-paste content in several flavors of
markup. So if some people want to write markdown et.al. offline then
paste it in the web-ui that's supported.

Most wikis are easy to theme and extend.

Most wikis have an active community that can help you develop any
missing features.

IMO what you need is a docs wiki that you can configure with your
publishing process as you see fit.

I don't have a vote for a specific wiki as I haven't done a comparison
of publishing work flows in a long time.

Did I mention, all IMO., no offense intended! :)

Cheers, Jeff.

-----BEGIN PGP SIGNATURE-----
Version: GnuPG v2.0.14 (GNU/Linux)

iQEcBAEBAgAGBQJVLbFIAAoJELs3R4zxGZvK1KcH/0MuqwXG3ZsUckUFm9QZrtzx
UEQKpcrdVFF/E2O3bAK4f6BtO0gXJTWQRsIAxnyfJ4vePCfpzgjFUIx0dgB4Ijn/
jf8/QpJsMvt08XjboIZU1eHQ2sT6tEUHJKsip48qufLPc0WmeqaToF8m1kZDa0Ba
042y3Yv2PWm0EdkxekxLP3bVl6395pGOnKXUUkfjHOMydN5ICEcq/al++If4Vqhd
hDiTayV41yTYZ5LPExTymppzqCclWE2iRqYVd1ATvMFEMlQuyHA+9xfZGfpmCbSo
OiaUzZ2dqtPL/WrjYGZuZBRV0AZsRxje4TqHnLDKaS4Oos2RV03uFV0OAHxYCQQ=
=Dr0H
-----END PGP SIGNATURE-----
-- 
docs mailing list
docs@xxxxxxxxxxxxxxxxxxxxxxx
To unsubscribe:
https://admin.fedoraproject.org/mailman/listinfo/docs





[Index of Archives]     [Fedora Users]     [Fedora Desktop]     [Red Hat 9]     [Yosemite News]     [KDE Users]

  Powered by Linux