[CentOS-docs] CentOS-docs Digest, Vol 114, Issue 3

Thu May 19 04:13:10 UTC 2016
Partners <partners at packtpub.com>

Hi Fabian, 

Thanks for your reply. 

Could you please direct me to the person who could give me the rights to add our books? 

Looking forward to hearing from you. 

Thanks & Regards 
Sherwin 




Sherwin Silveira 
Key Partner Executive 




----- Original Message -----

From: centos-docs-request at centos.org 
To: centos-docs at centos.org 
Sent: Wednesday, May 18, 2016 5:30:01 PM 
Subject: CentOS-docs Digest, Vol 114, Issue 3 

Send CentOS-docs mailing list submissions to 
centos-docs at centos.org 

To subscribe or unsubscribe via the World Wide Web, visit 
https://lists.centos.org/mailman/listinfo/centos-docs 
or, via email, send a message with subject or body 'help' to 
centos-docs-request at centos.org 

You can reach the person managing the list at 
centos-docs-owner at centos.org 

When replying, please edit your Subject line so it is more specific 
than "Re: Contents of CentOS-docs digest..." 


Today's Topics: 

1. Re: discussions around upstream documentation (Jim Perrin) 
2. Re: Request to contribute to wiki page (CentOS) (Fabian Arrotin) 


---------------------------------------------------------------------- 

Message: 1 
Date: Tue, 17 May 2016 07:09:58 -0500 
From: Jim Perrin <jperrin at centos.org> 
To: centos-docs at centos.org 
Subject: Re: [CentOS-docs] discussions around upstream documentation 
Message-ID: <573B0A16.3050709 at centos.org> 
Content-Type: text/plain; charset=windows-1252 

The Fedora team is working on moving away from docbook and xml to 
asciidoc. This is a more straightforward approach in the file, with a 
reasonably easy syntax to learn. This will let us keep docs in git so 
that users who find something and want to fix it can simply submit a 
pull request or patch to update and someone responsible can approve or 
deny it. 

In the future, it means that non-wiki docs should be easily consumable 
and editable. That doesn't help us for the current state of 
documentation, but it does help to resolve things for the future. I'm 
still working on the state of the existing docs via a few contacts I 
made at the docs day. 

On 05/17/2016 04:07 AM, Brian (bex) Exelbierd wrote: 
> Jim, 
> 
> What were the outcomes from a CentOS perspective? 
> 
> thank you. 
> 
> regards, 
> 
> bex 
> 
> On 04/11/2016 06:18 PM, Jim Perrin wrote: 
>> There is a Fedora Activity Day 
>> (https://fedoraproject.org/wiki/FAD_Documentation_2016 ) centered around 
>> documentation, where I'm going to see what can be done about the state 
>> of centos documentation from upstream sources. 
>> 
>> Most of the tooling for documentation for these two groups is centered 
>> around git. For the most part, our documentation currently lives in the 
>> wiki, and has a fairly high barrier to new contributors. 
>> 
>> Would the regulars who contribute on the wiki consider consider 
>> supporting a migration to a git based documentation workflow? 
>> 
>> I think this would help lower the barrier to contribution by allowing 
>> new contributors to submit a pull request or patch for documentation 
>> rather than join a mailing list, request access, etc. 
>> 
>> What are the thoughts or concerns about this sort of workflow change? 
>> 
>> 
>> 
>> 
> 

-- 
Jim Perrin 
The CentOS Project | http://www.centos.org 
twitter: @BitIntegrity | GPG Key: FA09AD77 


------------------------------ 

Message: 2 
Date: Tue, 17 May 2016 18:51:02 +0200 
From: Fabian Arrotin <arrfab at centos.org> 
To: centos-docs at centos.org 
Subject: Re: [CentOS-docs] Request to contribute to wiki page (CentOS) 
Message-ID: <573B4BF6.8040403 at centos.org> 
Content-Type: text/plain; charset="windows-1252" 

On 12/05/16 10:00, Fabian Arrotin wrote: 
> On 12/05/16 06:12, Partners wrote: 
>> Hi, 
>> 
>> We have received the subscription notification. 
>> Following is the information required to contribute to the wiki page: 
>> 
>> Username: PacktPublishing 
>> Subject: Book feature on the wiki page 
>> Location: https://wiki.centos.org/Books 
>> 
>> Thanks & Regards 
>> Sherwin 
>> 
>> *Sherwin Silveira* 
>> *Key Partner Executive* 
>> <https://www.packtpub.com/> 
>> 
> 
> Hi, 
> 
> Maybe I'm getting this wrong, but the goal of a wiki is to centralize 
> docs/howtos/tips-n-tricks on the wiki, and not promoting books ? Or are 
> those books under CC-by-SA license and so fully/freely available somewhere ? 
> 

Just reading that again and it seems that /Books already has links to 
other books, so I guess that the centos-docs team is ok with that. 
If so, someone can probably give you rights to add your books there. 

-- 
Fabian Arrotin 
The CentOS Project | http://www.centos.org 
gpg key: 56BEC54E | twitter: @arrfab 

-------------- next part -------------- 
A non-text attachment was scrubbed... 
Name: signature.asc 
Type: application/pgp-signature 
Size: 198 bytes 
Desc: OpenPGP digital signature 
URL: <http://lists.centos.org/pipermail/centos-docs/attachments/20160517/ab2c0ca3/attachment-0001.sig> 

------------------------------ 

_______________________________________________ 
CentOS-docs mailing list 
CentOS-docs at centos.org 
https://lists.centos.org/mailman/listinfo/centos-docs 


End of CentOS-docs Digest, Vol 114, Issue 3 
******************************************* 

-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://lists.centos.org/pipermail/centos-docs/attachments/20160519/de9645af/attachment-0005.html>
-------------- next part --------------
A non-text attachment was scrubbed...
Name: Packt Logo.png
Type: image/png
Size: 6817 bytes
Desc: not available
URL: <http://lists.centos.org/pipermail/centos-docs/attachments/20160519/de9645af/attachment-0005.png>