From kwade at redhat.com Thu Aug 17 23:39:10 2017 From: kwade at redhat.com (Karsten Wade) Date: Thu, 17 Aug 2017 16:39:10 -0700 Subject: [CentOS-docs] Installation Guide for CentOS Linux 7 Message-ID: <846f8ffd-511b-5c7e-5374-8478d463f832@redhat.com> Some time ago I started working, with Jim Perrin, on manually converting the single page HTML Red Hat Enterprise Linux 7 Installation Guide to be rebranded and reworked for CentOS Linux 7. https://github.com/CentOS/docs/tree/master/legacy_docs I wanted to alert folks that this is being worked on, that we want to get it completed ASAP to help support people migrating to CentOS Linux 7, and there are some areas I could use some help with. One of my key concerns as a technical writer is that content needs to be accurate and consistent. When there are inconsistencies or things are labeled incorrectly -- such as the document saying CentOS Linux and the screenshots saying Red Hat Enterprise Linux -- it greatly reduces the trust of the reader. Especially considering we're dealing with destructive installation methods, I don't want us to get things wrong. A simple caveat may not be enough. However ... redoing all the screenshots is a lot of work and I don't know that we want to hold back releasing this document for that. On one hand, anything we do is an improvement over the less-accurate-for-CentOS-Linux RHEL install guide ... but this blended/mixed set of inconsistencies might be worse for some users. An ongoing updated to-do list is maintained here: https://github.com/CentOS/docs/blob/master/legacy_docs/todo.md Overview of needs ================= * Document needs to be rebranded as CentOS (Linux & Project): - Links - Examples - Screenshots * How-to information needs to be stripped where it is not relevant: - Red Hat Subscription Manager - RHN & Satellite - Etc. * How-to information needs to be fixed or created for how things are done for CentOS: - Download images - Create install media - Do various tasks - Atomic Host how-to * Work arounds for sections removed that mess with chapter numbering Status ====== * Overall rebranding is completed, still working on some corner cases (where search & replace is not as easy such as split lines and   lines) * Internal links and section nesting seems OK but untested * Some sections commented out until we decide if we want to replace/rewrite them * New content may be needed for e.g. Atomic Host and cloud images. There are some other parts of the git repo that are placeholders such as for AsciiDoc work that may happen within the CentOS Project. Best regards, - Karsten -- Karsten Wade Community Infrastructure Team : https://osci.io Red Hat Open Source and Standards (OSAS) : @redhatopen @quaid gpg: AD0E0C41 -------------- next part -------------- A non-text attachment was scrubbed... Name: signature.asc Type: application/pgp-signature Size: 198 bytes Desc: OpenPGP digital signature URL: From bugs at centos.org Fri Aug 18 16:51:18 2017 From: bugs at centos.org (Gitblit) Date: Fri, 18 Aug 2017 16:51:18 +0000 (UTC) Subject: [CentOS-docs] [Gitblit] rbowen pushed 1 commits => websites/centos.org.git Message-ID: <20170818165232.F188C160607@m07.lon0.karan.org> https://git.centos.org/summary/websites!centos.org.git >--------------------------------------------------------------- master branch updated (1 commits) >--------------------------------------------------------------- Rich Bowen Friday, August 18, 2017 16:57 +0000 Update CERN Dojo URL https://git.centos.org/commit/websites!centos.org.git/53e77c2015e38429930eac0baf6aa4214131049f From kwade at redhat.com Thu Aug 17 23:39:10 2017 From: kwade at redhat.com (Karsten Wade) Date: Thu, 17 Aug 2017 16:39:10 -0700 Subject: [CentOS-docs] Installation Guide for CentOS Linux 7 Message-ID: <846f8ffd-511b-5c7e-5374-8478d463f832@redhat.com> Some time ago I started working, with Jim Perrin, on manually converting the single page HTML Red Hat Enterprise Linux 7 Installation Guide to be rebranded and reworked for CentOS Linux 7. https://github.com/CentOS/docs/tree/master/legacy_docs I wanted to alert folks that this is being worked on, that we want to get it completed ASAP to help support people migrating to CentOS Linux 7, and there are some areas I could use some help with. One of my key concerns as a technical writer is that content needs to be accurate and consistent. When there are inconsistencies or things are labeled incorrectly -- such as the document saying CentOS Linux and the screenshots saying Red Hat Enterprise Linux -- it greatly reduces the trust of the reader. Especially considering we're dealing with destructive installation methods, I don't want us to get things wrong. A simple caveat may not be enough. However ... redoing all the screenshots is a lot of work and I don't know that we want to hold back releasing this document for that. On one hand, anything we do is an improvement over the less-accurate-for-CentOS-Linux RHEL install guide ... but this blended/mixed set of inconsistencies might be worse for some users. An ongoing updated to-do list is maintained here: https://github.com/CentOS/docs/blob/master/legacy_docs/todo.md Overview of needs ================= * Document needs to be rebranded as CentOS (Linux & Project): - Links - Examples - Screenshots * How-to information needs to be stripped where it is not relevant: - Red Hat Subscription Manager - RHN & Satellite - Etc. * How-to information needs to be fixed or created for how things are done for CentOS: - Download images - Create install media - Do various tasks - Atomic Host how-to * Work arounds for sections removed that mess with chapter numbering Status ====== * Overall rebranding is completed, still working on some corner cases (where search & replace is not as easy such as split lines and   lines) * Internal links and section nesting seems OK but untested * Some sections commented out until we decide if we want to replace/rewrite them * New content may be needed for e.g. Atomic Host and cloud images. There are some other parts of the git repo that are placeholders such as for AsciiDoc work that may happen within the CentOS Project. Best regards, - Karsten -- Karsten Wade Community Infrastructure Team : https://osci.io Red Hat Open Source and Standards (OSAS) : @redhatopen @quaid gpg: AD0E0C41 -------------- next part -------------- A non-text attachment was scrubbed... Name: signature.asc Type: application/pgp-signature Size: 198 bytes Desc: OpenPGP digital signature URL: From bugs at centos.org Fri Aug 18 16:51:18 2017 From: bugs at centos.org (Gitblit) Date: Fri, 18 Aug 2017 16:51:18 +0000 (UTC) Subject: [CentOS-docs] [Gitblit] rbowen pushed 1 commits => websites/centos.org.git Message-ID: <20170818165232.F188C160607@m07.lon0.karan.org> https://git.centos.org/summary/websites!centos.org.git >--------------------------------------------------------------- master branch updated (1 commits) >--------------------------------------------------------------- Rich Bowen Friday, August 18, 2017 16:57 +0000 Update CERN Dojo URL https://git.centos.org/commit/websites!centos.org.git/53e77c2015e38429930eac0baf6aa4214131049f From kwade at redhat.com Thu Aug 17 23:39:10 2017 From: kwade at redhat.com (Karsten Wade) Date: Thu, 17 Aug 2017 16:39:10 -0700 Subject: [CentOS-docs] Installation Guide for CentOS Linux 7 Message-ID: <846f8ffd-511b-5c7e-5374-8478d463f832@redhat.com> Some time ago I started working, with Jim Perrin, on manually converting the single page HTML Red Hat Enterprise Linux 7 Installation Guide to be rebranded and reworked for CentOS Linux 7. https://github.com/CentOS/docs/tree/master/legacy_docs I wanted to alert folks that this is being worked on, that we want to get it completed ASAP to help support people migrating to CentOS Linux 7, and there are some areas I could use some help with. One of my key concerns as a technical writer is that content needs to be accurate and consistent. When there are inconsistencies or things are labeled incorrectly -- such as the document saying CentOS Linux and the screenshots saying Red Hat Enterprise Linux -- it greatly reduces the trust of the reader. Especially considering we're dealing with destructive installation methods, I don't want us to get things wrong. A simple caveat may not be enough. However ... redoing all the screenshots is a lot of work and I don't know that we want to hold back releasing this document for that. On one hand, anything we do is an improvement over the less-accurate-for-CentOS-Linux RHEL install guide ... but this blended/mixed set of inconsistencies might be worse for some users. An ongoing updated to-do list is maintained here: https://github.com/CentOS/docs/blob/master/legacy_docs/todo.md Overview of needs ================= * Document needs to be rebranded as CentOS (Linux & Project): - Links - Examples - Screenshots * How-to information needs to be stripped where it is not relevant: - Red Hat Subscription Manager - RHN & Satellite - Etc. * How-to information needs to be fixed or created for how things are done for CentOS: - Download images - Create install media - Do various tasks - Atomic Host how-to * Work arounds for sections removed that mess with chapter numbering Status ====== * Overall rebranding is completed, still working on some corner cases (where search & replace is not as easy such as split lines and   lines) * Internal links and section nesting seems OK but untested * Some sections commented out until we decide if we want to replace/rewrite them * New content may be needed for e.g. Atomic Host and cloud images. There are some other parts of the git repo that are placeholders such as for AsciiDoc work that may happen within the CentOS Project. Best regards, - Karsten -- Karsten Wade Community Infrastructure Team : https://osci.io Red Hat Open Source and Standards (OSAS) : @redhatopen @quaid gpg: AD0E0C41 -------------- next part -------------- A non-text attachment was scrubbed... Name: signature.asc Type: application/pgp-signature Size: 198 bytes Desc: OpenPGP digital signature URL: From bugs at centos.org Fri Aug 18 16:51:18 2017 From: bugs at centos.org (Gitblit) Date: Fri, 18 Aug 2017 16:51:18 +0000 (UTC) Subject: [CentOS-docs] [Gitblit] rbowen pushed 1 commits => websites/centos.org.git Message-ID: <20170818165232.F188C160607@m07.lon0.karan.org> https://git.centos.org/summary/websites!centos.org.git >--------------------------------------------------------------- master branch updated (1 commits) >--------------------------------------------------------------- Rich Bowen Friday, August 18, 2017 16:57 +0000 Update CERN Dojo URL https://git.centos.org/commit/websites!centos.org.git/53e77c2015e38429930eac0baf6aa4214131049f From kwade at redhat.com Thu Aug 17 23:39:10 2017 From: kwade at redhat.com (Karsten Wade) Date: Thu, 17 Aug 2017 16:39:10 -0700 Subject: [CentOS-docs] Installation Guide for CentOS Linux 7 Message-ID: <846f8ffd-511b-5c7e-5374-8478d463f832@redhat.com> Some time ago I started working, with Jim Perrin, on manually converting the single page HTML Red Hat Enterprise Linux 7 Installation Guide to be rebranded and reworked for CentOS Linux 7. https://github.com/CentOS/docs/tree/master/legacy_docs I wanted to alert folks that this is being worked on, that we want to get it completed ASAP to help support people migrating to CentOS Linux 7, and there are some areas I could use some help with. One of my key concerns as a technical writer is that content needs to be accurate and consistent. When there are inconsistencies or things are labeled incorrectly -- such as the document saying CentOS Linux and the screenshots saying Red Hat Enterprise Linux -- it greatly reduces the trust of the reader. Especially considering we're dealing with destructive installation methods, I don't want us to get things wrong. A simple caveat may not be enough. However ... redoing all the screenshots is a lot of work and I don't know that we want to hold back releasing this document for that. On one hand, anything we do is an improvement over the less-accurate-for-CentOS-Linux RHEL install guide ... but this blended/mixed set of inconsistencies might be worse for some users. An ongoing updated to-do list is maintained here: https://github.com/CentOS/docs/blob/master/legacy_docs/todo.md Overview of needs ================= * Document needs to be rebranded as CentOS (Linux & Project): - Links - Examples - Screenshots * How-to information needs to be stripped where it is not relevant: - Red Hat Subscription Manager - RHN & Satellite - Etc. * How-to information needs to be fixed or created for how things are done for CentOS: - Download images - Create install media - Do various tasks - Atomic Host how-to * Work arounds for sections removed that mess with chapter numbering Status ====== * Overall rebranding is completed, still working on some corner cases (where search & replace is not as easy such as split lines and   lines) * Internal links and section nesting seems OK but untested * Some sections commented out until we decide if we want to replace/rewrite them * New content may be needed for e.g. Atomic Host and cloud images. There are some other parts of the git repo that are placeholders such as for AsciiDoc work that may happen within the CentOS Project. Best regards, - Karsten -- Karsten Wade Community Infrastructure Team : https://osci.io Red Hat Open Source and Standards (OSAS) : @redhatopen @quaid gpg: AD0E0C41 -------------- next part -------------- A non-text attachment was scrubbed... Name: signature.asc Type: application/pgp-signature Size: 198 bytes Desc: OpenPGP digital signature URL: From bugs at centos.org Fri Aug 18 16:51:18 2017 From: bugs at centos.org (Gitblit) Date: Fri, 18 Aug 2017 16:51:18 +0000 (UTC) Subject: [CentOS-docs] [Gitblit] rbowen pushed 1 commits => websites/centos.org.git Message-ID: <20170818165232.F188C160607@m07.lon0.karan.org> https://git.centos.org/summary/websites!centos.org.git >--------------------------------------------------------------- master branch updated (1 commits) >--------------------------------------------------------------- Rich Bowen Friday, August 18, 2017 16:57 +0000 Update CERN Dojo URL https://git.centos.org/commit/websites!centos.org.git/53e77c2015e38429930eac0baf6aa4214131049f From kwade at redhat.com Thu Aug 17 23:39:10 2017 From: kwade at redhat.com (Karsten Wade) Date: Thu, 17 Aug 2017 16:39:10 -0700 Subject: [CentOS-docs] Installation Guide for CentOS Linux 7 Message-ID: <846f8ffd-511b-5c7e-5374-8478d463f832@redhat.com> Some time ago I started working, with Jim Perrin, on manually converting the single page HTML Red Hat Enterprise Linux 7 Installation Guide to be rebranded and reworked for CentOS Linux 7. https://github.com/CentOS/docs/tree/master/legacy_docs I wanted to alert folks that this is being worked on, that we want to get it completed ASAP to help support people migrating to CentOS Linux 7, and there are some areas I could use some help with. One of my key concerns as a technical writer is that content needs to be accurate and consistent. When there are inconsistencies or things are labeled incorrectly -- such as the document saying CentOS Linux and the screenshots saying Red Hat Enterprise Linux -- it greatly reduces the trust of the reader. Especially considering we're dealing with destructive installation methods, I don't want us to get things wrong. A simple caveat may not be enough. However ... redoing all the screenshots is a lot of work and I don't know that we want to hold back releasing this document for that. On one hand, anything we do is an improvement over the less-accurate-for-CentOS-Linux RHEL install guide ... but this blended/mixed set of inconsistencies might be worse for some users. An ongoing updated to-do list is maintained here: https://github.com/CentOS/docs/blob/master/legacy_docs/todo.md Overview of needs ================= * Document needs to be rebranded as CentOS (Linux & Project): - Links - Examples - Screenshots * How-to information needs to be stripped where it is not relevant: - Red Hat Subscription Manager - RHN & Satellite - Etc. * How-to information needs to be fixed or created for how things are done for CentOS: - Download images - Create install media - Do various tasks - Atomic Host how-to * Work arounds for sections removed that mess with chapter numbering Status ====== * Overall rebranding is completed, still working on some corner cases (where search & replace is not as easy such as split lines and   lines) * Internal links and section nesting seems OK but untested * Some sections commented out until we decide if we want to replace/rewrite them * New content may be needed for e.g. Atomic Host and cloud images. There are some other parts of the git repo that are placeholders such as for AsciiDoc work that may happen within the CentOS Project. Best regards, - Karsten -- Karsten Wade Community Infrastructure Team : https://osci.io Red Hat Open Source and Standards (OSAS) : @redhatopen @quaid gpg: AD0E0C41 -------------- next part -------------- A non-text attachment was scrubbed... Name: signature.asc Type: application/pgp-signature Size: 198 bytes Desc: OpenPGP digital signature URL: From bugs at centos.org Fri Aug 18 16:51:18 2017 From: bugs at centos.org (Gitblit) Date: Fri, 18 Aug 2017 16:51:18 +0000 (UTC) Subject: [CentOS-docs] [Gitblit] rbowen pushed 1 commits => websites/centos.org.git Message-ID: <20170818165232.F188C160607@m07.lon0.karan.org> https://git.centos.org/summary/websites!centos.org.git >--------------------------------------------------------------- master branch updated (1 commits) >--------------------------------------------------------------- Rich Bowen Friday, August 18, 2017 16:57 +0000 Update CERN Dojo URL https://git.centos.org/commit/websites!centos.org.git/53e77c2015e38429930eac0baf6aa4214131049f From kwade at redhat.com Thu Aug 17 23:39:10 2017 From: kwade at redhat.com (Karsten Wade) Date: Thu, 17 Aug 2017 16:39:10 -0700 Subject: [CentOS-docs] Installation Guide for CentOS Linux 7 Message-ID: <846f8ffd-511b-5c7e-5374-8478d463f832@redhat.com> Some time ago I started working, with Jim Perrin, on manually converting the single page HTML Red Hat Enterprise Linux 7 Installation Guide to be rebranded and reworked for CentOS Linux 7. https://github.com/CentOS/docs/tree/master/legacy_docs I wanted to alert folks that this is being worked on, that we want to get it completed ASAP to help support people migrating to CentOS Linux 7, and there are some areas I could use some help with. One of my key concerns as a technical writer is that content needs to be accurate and consistent. When there are inconsistencies or things are labeled incorrectly -- such as the document saying CentOS Linux and the screenshots saying Red Hat Enterprise Linux -- it greatly reduces the trust of the reader. Especially considering we're dealing with destructive installation methods, I don't want us to get things wrong. A simple caveat may not be enough. However ... redoing all the screenshots is a lot of work and I don't know that we want to hold back releasing this document for that. On one hand, anything we do is an improvement over the less-accurate-for-CentOS-Linux RHEL install guide ... but this blended/mixed set of inconsistencies might be worse for some users. An ongoing updated to-do list is maintained here: https://github.com/CentOS/docs/blob/master/legacy_docs/todo.md Overview of needs ================= * Document needs to be rebranded as CentOS (Linux & Project): - Links - Examples - Screenshots * How-to information needs to be stripped where it is not relevant: - Red Hat Subscription Manager - RHN & Satellite - Etc. * How-to information needs to be fixed or created for how things are done for CentOS: - Download images - Create install media - Do various tasks - Atomic Host how-to * Work arounds for sections removed that mess with chapter numbering Status ====== * Overall rebranding is completed, still working on some corner cases (where search & replace is not as easy such as split lines and   lines) * Internal links and section nesting seems OK but untested * Some sections commented out until we decide if we want to replace/rewrite them * New content may be needed for e.g. Atomic Host and cloud images. There are some other parts of the git repo that are placeholders such as for AsciiDoc work that may happen within the CentOS Project. Best regards, - Karsten -- Karsten Wade Community Infrastructure Team : https://osci.io Red Hat Open Source and Standards (OSAS) : @redhatopen @quaid gpg: AD0E0C41 -------------- next part -------------- A non-text attachment was scrubbed... Name: signature.asc Type: application/pgp-signature Size: 198 bytes Desc: OpenPGP digital signature URL: From bugs at centos.org Fri Aug 18 16:51:18 2017 From: bugs at centos.org (Gitblit) Date: Fri, 18 Aug 2017 16:51:18 +0000 (UTC) Subject: [CentOS-docs] [Gitblit] rbowen pushed 1 commits => websites/centos.org.git Message-ID: <20170818165232.F188C160607@m07.lon0.karan.org> https://git.centos.org/summary/websites!centos.org.git >--------------------------------------------------------------- master branch updated (1 commits) >--------------------------------------------------------------- Rich Bowen Friday, August 18, 2017 16:57 +0000 Update CERN Dojo URL https://git.centos.org/commit/websites!centos.org.git/53e77c2015e38429930eac0baf6aa4214131049f