Fwd: Contributing docs for maintaining and creating a Fedora remix Comments

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

 



Forgot this bit.

---------- Forwarded message ---------
From: Leslie S Satenstein <lsatenstein@xxxxxxxxx>
Date: Tue, Apr 24, 2018, 8:51 PM
Subject: Re: Contributing docs for maintaining and creating a Fedora remix Comments
To: Aidan Kahrs <abkahrs@xxxxxxxxx>


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@xxxxxxxxx>
To: For participants of the Documentation Project <docs@xxxxxxxxxxxxxxxxxxxxxxx>
Cc: Leslie S Satenstein <lsatenstein@xxxxxxxxx>
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

On Tue, Apr 24, 2018, 1:04 PM Brian (bex) Exelbierd <bexelbie@xxxxxxxxxx> wrote:


On Tue, Apr 24, 2018 at 6:54 PM, Leslie S Satenstein <lsatenstein@xxxxxxxxx> 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@xxxxxxxxxx>
To: Development discussions related to Fedora <devel@xxxxxxxxxxxxxxxxxxxxxxx>
Cc: For participants of the Documentation Project <docs@xxxxxxxxxxxxxxxxxxxxxxx>; "tigeros@xxxxxxxxxx" <tigeros@xxxxxxxxxx>
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@xxxxxxxxx> wrote:
On Tue, Apr 24, 2018 at 5:03 AM, Brian (bex) Exelbierd
<bexelbie@xxxxxxxxxx> 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@xxxxxxxxx> 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
>
>
> 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

 



--
真実はいつも一つ!/ Always, there's only one truth!
______________________________ _________________
devel mailing list -- devel@xxxxxxxxxxxxxxxxxxxxxxx
To unsubscribe send an email to devel-leave@lists. fedoraproject.org



--
Brian (bex) Exelbierd | bexelbie@xxxxxxxxxx | bex@xxxxxxxxx
Fedora Community Action & Impact Coordinator
@bexelbie | http://www.winglemeyer.org
_______________________________________________
docs mailing list -- docs@xxxxxxxxxxxxxxxxxxxxxxx
To unsubscribe send an email to docs-leave@xxxxxxxxxxxxxxxxxxxxxxx



_______________________________________________
docs mailing list -- docs@xxxxxxxxxxxxxxxxxxxxxxx
To unsubscribe send an email to docs-leave@xxxxxxxxxxxxxxxxxxxxxxx




--
Brian (bex) Exelbierd | bexelbie@xxxxxxxxxx | bex@xxxxxxxxx
Fedora Community Action & Impact Coordinator
@bexelbie | http://www.winglemeyer.org
_______________________________________________
docs mailing list -- docs@xxxxxxxxxxxxxxxxxxxxxxx
To unsubscribe send an email to docs-leave@xxxxxxxxxxxxxxxxxxxxxxx


_______________________________________________
docs mailing list -- docs@xxxxxxxxxxxxxxxxxxxxxxx
To unsubscribe send an email to docs-leave@xxxxxxxxxxxxxxxxxxxxxxx

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

  Powered by Linux