Message to Ben and working group
Yes your standard is asciidoc, but for collaboration, I proceeded to use libreoffice with the track changes and Comments options.
I have vetted, corrected grammer, added punctuation, reoved run-on sentences, and also revised some old stuff left over from Fedora 21.
So, I have a tract changes mark up of the install guide. If someone collaborates with me to review the changes, it will not be a difficult job to
past the output into asciidoc format
I feel that collaaboration is a team effort, to review changes, so as to produce a good pdf output (LibreOffice does produce pdf output, if requested, It also, for those not in the know, produces output for docx odt, and other formats.
I have used asciidoc and just find that it is acceptable, because the maintenance is in ascii, but it is not convenient for tracking changes and collaboration.
I have reviewed about 100 pages of output. With two one hour settings, (approving, rejecting markups), a good start will be possible for producing the Fedora 35 install guide.
Regards
Leslie
Leslie
Leslie Satenstein
Montréal Québec, Canada
On Friday, September 24, 2021, 02:57:17 p.m. GMT-4, Ben Cotton <bcotton@xxxxxxxxxx> wrote:
On Fri, Sep 24, 2021 at 4:47 AM Allan Day <aday@xxxxxxxxxx> wrote:
>
> I'm working on migrating the Workstation Working Group from the wiki
> to docs.fedoraproject.org.
>
> Our docs project is located at
> https://pagure.io/fedora-workstation/workstation-docs . Could you add
> it to the website, please?!
pbokoc beat me to it this morning. (And it was very clever of git to
figure out that I was trying to push a change that was already made.)
I will point out that your docs have "main" in the URL (e.g.
https://docs.fedoraproject.org/en-US/workstation-working-group/main/ )
because Antora has "master" hardcoded. We found this out the hard way
with the Council docs. So if you don't want that, you'll need to set
`version` back to `master` in line 9 of your `antora.yml` file. If
you're fine with that, then leave it as-is.
--
Ben Cotton
He / Him / His
Fedora Program Manager
Red Hat
TZ=America/Indiana/Indianapolis
_______________________________________________
docs mailing list -- docs@xxxxxxxxxxxxxxxxxxxxxxx
To unsubscribe send an email to docs-leave@xxxxxxxxxxxxxxxxxxxxxxx
Fedora Code of Conduct: https://docs.fedoraproject.org/en-US/project/code-of-conduct/
List Guidelines: https://fedoraproject.org/wiki/Mailing_list_guidelines
List Archives: https://lists.fedoraproject.org/archives/list/docs@xxxxxxxxxxxxxxxxxxxxxxx
Do not reply to spam on the list, report it: https://pagure.io/fedora-infrastructure
>
> I'm working on migrating the Workstation Working Group from the wiki
> to docs.fedoraproject.org.
>
> Our docs project is located at
> https://pagure.io/fedora-workstation/workstation-docs . Could you add
> it to the website, please?!
pbokoc beat me to it this morning. (And it was very clever of git to
figure out that I was trying to push a change that was already made.)
I will point out that your docs have "main" in the URL (e.g.
https://docs.fedoraproject.org/en-US/workstation-working-group/main/ )
because Antora has "master" hardcoded. We found this out the hard way
with the Council docs. So if you don't want that, you'll need to set
`version` back to `master` in line 9 of your `antora.yml` file. If
you're fine with that, then leave it as-is.
--
Ben Cotton
He / Him / His
Fedora Program Manager
Red Hat
TZ=America/Indiana/Indianapolis
_______________________________________________
docs mailing list -- docs@xxxxxxxxxxxxxxxxxxxxxxx
To unsubscribe send an email to docs-leave@xxxxxxxxxxxxxxxxxxxxxxx
Fedora Code of Conduct: https://docs.fedoraproject.org/en-US/project/code-of-conduct/
List Guidelines: https://fedoraproject.org/wiki/Mailing_list_guidelines
List Archives: https://lists.fedoraproject.org/archives/list/docs@xxxxxxxxxxxxxxxxxxxxxxx
Do not reply to spam on the list, report it: https://pagure.io/fedora-infrastructure
_______________________________________________ docs mailing list -- docs@xxxxxxxxxxxxxxxxxxxxxxx To unsubscribe send an email to docs-leave@xxxxxxxxxxxxxxxxxxxxxxx Fedora Code of Conduct: https://docs.fedoraproject.org/en-US/project/code-of-conduct/ List Guidelines: https://fedoraproject.org/wiki/Mailing_list_guidelines List Archives: https://lists.fedoraproject.org/archives/list/docs@xxxxxxxxxxxxxxxxxxxxxxx Do not reply to spam on the list, report it: https://pagure.io/fedora-infrastructure
