On 01/10/2014 05:22 PM, Philip Mather wrote:
Has there been any interest or progress in the suggested Documentation SIG?
Is this proposal to 'write more docs' or
Is it more of a religious 'everyone should write more docs, we will
create resources, make it easier' etc ?
step1, lets define the problem :)
- K
Having worked on Fedora Docs for many years I would like to make a suggestion that the same model is followed, just in reverse. Many Red Hat docs start as Fedora Documentation and are tweaked to fit RH products. CentOS can use the RH docs as a base and remove the unneeded content. While it will not provide everything CentOS needs for documentation a lot of good content has already been written as in licensed so that it can be reused (CC BY-SA 3.0).
I may be making an incorrect assumption, but it is worth mentioning.
On 01/17/2014 01:43 PM, Zachary Oglesby wrote:
On 01/10/2014 05:22 PM, Philip Mather wrote:
/ Has there been any interest or progress in the suggested Documentation SIG?
/>>/ />
Is this proposal to 'write more docs' or
Is it more of a religious 'everyone should write more docs, we will
create resources, make it easier' etc ?
step1, lets define the problem :)
- K
Having worked on Fedora Docs for many years I would like to make a suggestion that the same model is followed, just in reverse. Many Red Hat docs start as Fedora Documentation and are tweaked to fit RH products. CentOS can use the RH docs as a base and remove the unneeded content. While it will not provide everything CentOS needs for documentation a lot of good content has already been written as in licensed so that it can be reused (CC BY-SA 3.0).
I may be making an incorrect assumption, but it is worth mentioning.
thats a great suggestion - It would be absolutely great to see some people adapt the RHEL-6 ( and 7 ? ) docs to CentOS-6/7, and as you mentioned, its a case of using rm -rf ( carefully ) in the right places.
What do we need to get started ?
- KB
-----BEGIN PGP SIGNED MESSAGE----- Hash: SHA1
On 01/17/2014 05:43 AM, Zachary Oglesby wrote:
Having worked on Fedora Docs for many years I would like to make a suggestion that the same model is followed, just in reverse.
You'll find me still opinionated on that one :) but generally I agree.
Many Red Hat docs start as Fedora Documentation and are tweaked to fit RH products. CentOS can use the RH docs as a base and remove the unneeded content. While it will not provide everything CentOS needs for documentation a lot of good content has already been written as in licensed so that it can be reused (CC BY-SA 3.0).
I may be making an incorrect assumption, but it is worth mentioning.
What we need are the doc SRPMs for all the guides. I think the DocBook/Publican is a bit of a barrier to participation, but much less than converting manually from the rendered HTML.
The challenge with the big guides is working with them is a different discipline than drive-by submissions, and different than short how-to articles on the wiki, etc.
The big guides discipline may take some building, where we can probably find ways to get people successful right away working in MarkDown or AsciiDoc and submitting pull requests, etc. Maybe a two-pronged approach, short-term and longer-term?
- - Karsten - -- Karsten 'quaid' Wade .^\ CentOS Engineering Manager http://TheOpenSourceWay.org \ http://community.redhat.com @quaid (identi.ca/twitter/IRC) \v' gpg: AD0E0C41
On Jan 17, 2014 6:43 AM, "Zachary Oglesby" zach@oglesby.co wrote:
On 01/10/2014 05:22 PM, Philip Mather wrote:
Has there been any interest or progress in the suggested Documentation
SIG?
Is this proposal to 'write more docs' or
Is it more of a religious 'everyone should write more docs, we will
create resources, make it easier' etc ?
step1, lets define the problem :)
- K
Having worked on Fedora Docs for many years I would like to make a
suggestion that the same model is followed, just in reverse. Many Red Hat docs start as Fedora Documentation and are tweaked to fit RH products. CentOS can use the RH docs as a base and remove the unneeded content. While it will not provide everything CentOS needs for documentation a lot of good content has already been written as in licensed so that it can be reused (CC BY-SA 3.0).
I may be making an incorrect assumption, but it is worth mentioning.
I also contribute to Fedora Docs and am very interested to see how the CentOS documentation effort develops. The changes coming in EL7 especially give a base for common cause. I'm confident that open communication and a collaborative relationship between the two groups would be mutually beneficial.
I'll send a separate mail to the centos-docs and docs@fp.o lists on the subject soon.
--Pete
-
Karanbir Singh -
Karsten Wade -
Pete Travis -
Zachary Oglesby