Re: Antora for Docs: making sure our contributors are on board

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

 



Hey Justin,

There will be some slight changed to the source repo, too. But don't worry, no format changes (it's still asciidoc), just the structure and the definition of the menu on the left will be a bit different. I'll prepare materials with all the info needed for you to switch. Also happy to assist.

Adam

On Fri, Jun 29, 2018 at 9:38 PM Justin W. Flory <jflory7@xxxxxxxxx> wrote:
On 06/12/2018 12:10 PM, Adam Samalik wrote:
> * Announce it here on this very list.
> * Contact in advance every group having their docs on the site and:
> ** making sure we have converted their asciibinder source into the
> Antora source right
> ** making sure they know how to make changes
> * Do this over a few days, switching the Antora branches in all
> repositories the site is built from to be the main branches. During
> these few days, the current asciibinder site wouldn't update. All
> updates from this period would end up on the new site. Basically, doing
> a few-days-log freeze.
>
> How does that sound? Anything I've missed?
>

I'm late, but +1 to this plan too.

>From the CommOps / sub-project POV, I would like to better know what
changes I need to do to update our documentation. My understanding prior
was that Antora would be a backend change and I would not have to make
adjustments to our docs. It's fine if we need to make changes, but I
will be curious to know what is needed and how to do it, so I can set up
documentation for other sub-projects waiting to move:

    https://pagure.io/fedora-diversity/issue/61

--
Cheers,
Justin W. Flory
jflory7@xxxxxxxxx

_______________________________________________
docs mailing list -- docs@xxxxxxxxxxxxxxxxxxxxxxx
To unsubscribe send an email to docs-leave@xxxxxxxxxxxxxxxxxxxxxxx
Fedora Code of Conduct: https://getfedora.org/code-of-conduct.html
List Guidelines: https://fedoraproject.org/wiki/Mailing_list_guidelines
List Archives: https://lists.fedoraproject.org/archives/list/docs@xxxxxxxxxxxxxxxxxxxxxxx/message/NHPPTS4LNANVIPKCPIJHRK2W7Z6CTPHS/


--

Adam Šamalík
---------------------------
Software Engineer
Red Hat
_______________________________________________
docs mailing list -- docs@xxxxxxxxxxxxxxxxxxxxxxx
To unsubscribe send an email to docs-leave@xxxxxxxxxxxxxxxxxxxxxxx
Fedora Code of Conduct: https://getfedora.org/code-of-conduct.html
List Guidelines: https://fedoraproject.org/wiki/Mailing_list_guidelines
List Archives: https://lists.fedoraproject.org/archives/list/docs@xxxxxxxxxxxxxxxxxxxxxxx/message/QDBLG5B4JBMY43KZ5GVBUMLVE36TT4I7/

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

  Powered by Linux