Forgot this bit.
---------- Forwarded message --------- From: Leslie S Satenstein lsatenstein@yahoo.com Date: Tue, Apr 24, 2018, 8:51 PM Subject: Re: Contributing docs for maintaining and creating a Fedora remix Comments To: Aidan Kahrs abkahrs@gmail.com
Hi Aidan
Thank you for the prompt reply.
For the topic I was reading, I was asking questions as if I am a first time Linux user who was told, «go build an ISO file»
As I mentioned, I tweaked or rephrased a sentence or two, to make it more useful to non-English speakers.
I could also help with the French editing (My French is Québec's version). French is a very very precise language. Any lawyer would tell you that a contract written in French is "tighter", ie, more precise than one written in English. We also must not write to put the reader to sleep.
As I mentioned to Bex, I like to see a completed document. I am not too into your writing tools. Years ago I used IBM's gml and took a dislike to the labor involved with repeated "running, reviewing the output, tweaking" until ...
I am glad to help
Regards
* Leslie* *Leslie Satenstein* *Montréal Québec, Canada*
------------------------------ *From:* Aidan Kahrs abkahrs@gmail.com *To:* For participants of the Documentation Project < docs@lists.fedoraproject.org> *Cc:* Leslie S Satenstein lsatenstein@yahoo.com *Sent:* Tuesday, April 24, 2018 1:29 PM *Subject:* Re: Contributing docs for maintaining and creating a Fedora remix Comments
Leslie, Thank you for the suggestions on phrasing. We will certainly consider them and are open to pull requests once the final version has been published. Thank you. Sincerely,
Aidan Kahrs abkahrs@fedoraproject.org
On Tue, Apr 24, 2018, 1:04 PM Brian (bex) Exelbierd bexelbie@redhat.com wrote:
On Tue, Apr 24, 2018 at 6:54 PM, Leslie S Satenstein lsatenstein@yahoo.com wrote:
Brian Is it possible for me to get a "text document or libreoffice word document?"
The link https://pagure.io/fedora-docs/remix-building/blob/master/f/remix-ci.adoc leads to an AsciiDoc formatted text document. Asciidoc is described at asciidoctor.org and is the current preferred documentation format.
The author starts by saying using Jenkins.
What is Jenkins and where can I get it or information about it. Not stated in the draft.
Jenkins is a CI system. It is reasonable that readers of this document would know this. https://jenkins.io/
Example of correction:
The choice of CentOS was to maximize support time and stay within the RHEL family. The choice of using CentOS was to maximize support time and to stay within the RHEL family. I would have written
The decision to use CentOS was to maximize support time and to stay within the RHEL family.
I did write you earlier about doing some editing and writing. I would be glad to work with authors to proof their writing.
I am sure they would appreciate it.
I presume you can accept updates after go-live.
I don't see why they wouldn't. I know they would prefer PRs via pagure.io.
regards,
bex
Regards
* Leslie* *Leslie Satenstein* *Montréal Québec, Canada*
------------------------------ *From:* Brian (bex) Exelbierd bexelbie@redhat.com *To:* Development discussions related to Fedora < devel@lists.fedoraproject.org> *Cc:* For participants of the Documentation Project < docs@lists.fedoraproject.org>; "tigeros@ritlug.com" tigeros@ritlug.com *Sent:* Tuesday, April 24, 2018 5:56 AM *Subject:* Re: Contributing docs for maintaining and creating a Fedora remix
On Tue, Apr 24, 2018 at 11:19 AM, Neal Gompa ngompa13@gmail.com wrote:
On Tue, Apr 24, 2018 at 5:03 AM, Brian (bex) Exelbierd bexelbie@redhat.com wrote:
+devel list to attract feedback from other folks in releng or working on other remixes and spins
On Mon, Apr 23, 2018 at 7:04 PM, Aidan Kahrs abkahrs@gmail.com wrote:
Hello. I know this thread has been kinda quiet the last few days. I wanted to
put
out an update that the draft documentation is finished. I have gotten
input
from my team. I would now like input from people within the docs effort before I say it is ready to publish.
The draft docs can be found at https://pagure.io/fedora-docs/ remix-building/blob/master/f/
remix-ci.adoc https://pagure.io/fedora-docs/remix-building/blob/master/f/remix-ci.adoc
One comment:
14: Why is this server required to be a CentOS server? I have no problem with CentOS but we should explain that choice in the context of a Fedora Remix.
My experience is that it _should not_ be anything but a Fedora system. It should be at least be the target Fedora version or higher. Ideally, you always run the target version's livemedia-creator+Anaconda, which is why Koji uses mock to set up the environment and then run it inside of there.
In addition, it's a very bad idea to recommend using "createrepo" instead of "createrepo_c", due to the former not supporting most of Fedora's newer RPM features and potentially weird things happening there.
If you're using livecd-creator, you can get away with a lot more, since you're no longer sensitive to Anaconda's fragilities and the build engine is DNF.
I believe we may be talking about different servers. The page seems to indicate the CentOS server is used to serve the bits.
regards,
bex