Release Notes in AsciiDoc, first draft

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

 



Hi all,

Apologies for dragging my feet with this.

I converted the current version of F26 Release Notes. You can see the
result in https://pagure.io/release-notes/branch/f26-adoc

To check out the branch on local, run:

$ git checkout --track origin/f26-adoc

To build the doc using AsciiDoctor, run:

$ asciidoctor -a toc -n master.adoc

(and open the resulting master.html file)

I think the result is pretty good. I hope to have fixed all problems
that came up during the conversion. While doing so, I also fixed and
improved some mark-up and removed all hard line breaks in text
paragraphs.

If you want to fix stuff in the content of RtN, I suggest you work
with the AsciiDoc sources from now on to avoid the need to port
changes from DocBook to AsciiDoc again.

One thing I wasn't sure about: the DocBook original includes a bunch
of empty chapter files (areas that didn't receive any notes for F26).
I decided not to include them. I'm not sure why we carry them around.
But please, let me know if you think they should be in the repo.

Robert,
Robert
_______________________________________________
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