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 topast 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 Satenstein Montréal Québec, Canada

On Friday, September 24, 2021, 02:57:17 p.m. GMT-4, Ben Cotton bcotton@redhat.com wrote:

On Fri, Sep 24, 2021 at 4:47 AM Allan Day aday@redhat.com 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.

On Fri, Sep 24, 2021 at 10:08:58PM +0000, Leslie S Satenstein wrote:

...

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.

Thanks for volunteering to help with the documentation Leslie! Since you are working on the installation guide, you may find the examples on the page linked below insightful.

https://pagure.io/fedora-docs/install-guide/pull-requests?status=False

Each "Pull Request" listed on the above linked page tracks exactly who made exactly what change and when (browse the "Files Changed" tab for each PR to see exactly what was changed). There is a bit of a learning curve to using git if you aren't already familiar with it. But it is extremely powerful in terms of its ability to track changes (they can also be undone and "cherry picked" and there is support for merging conflicting changes by different authors but you don't need to worry about any of that to get started).

I would suggest starting small just to get things figured out. Try submitting a pull request to correct a small grammar mistake or typo first just to get the hang of how things work. Your submission should show up on the "Pull Requests" tab here: https://pagure.io/fedora-docs/install-guide

Once accepted ("merged"), the record of your change will be archived under the "XX Merged" link on the pull requests page.

Thanks for contributing!

On Thu, Oct 7, 2021 at 6:33 AM Allan Day aday@redhat.com wrote:

Is there a ticket anywhere, tracking this issue? I think I'm probably going to have to change the default branch name to master, but I'd like to switch it back to main as soon as it's possible to do so.

Looks like it's been fixed upstream: https://gitlab.com/antora/antora/-/issues/669

So I guess now it's up to us (asamalik?) to update our tooling.