Introducing the new docs site

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

 



Hi everyone,

as you might have noticed, we now have an actual docs site with an install guide: https://docs.centos.org/

It's very much a work in progress (I need to figure out how to get rid of the two navbars on the main page and a bunch of other things), but I believe even in the current state it's going to be useful to any CentOS users. The Installation Guide is adapted from the RHEL7 Install Guide, and I'll be looking at ways to get our own release notes published using the new system as well. The markup language used is ASCIIDoc[0], and the system that builds the site is Antora[1].

The site is built using the original "docs" repository[2]. The repo contains a set of configuration files and a build script (build.sh) that builds the whole site. If you have an issue to report that relates to the website itself - CSS problems, general look and feel, etc., this is the place to do so.

The Installation Guide content lives in docs-installation-guide[3]. Any issues relating to the actual Installation Guide (like, for example, how it talks about Red Hat Enterprise Virtualization even though it's been renamed to RHV) should be reported against this repo.

The third new repository, docs-web[4], contains the built site and shouldn't ever be touched. When I rebuild the site using the docs repo, I'll grab the output from docs/public, move it to docs-web/en-US, and tell Fabian to pull and publish that. Of course this will be automated eventually, and we should get a staging function as well using a different branch.

Next steps for me are to fix the navbars, make another repo that will store the UI project (that generates the UI bundle in docs-web which determines how the site looks), and I'll also write READMEs for each repo so you'll be able to see what each one is for without having to refer to this mail - this is just a quick explanation of how the system works.

Cheers,

Petr

[0] https://asciidoctor.org/docs/user-manual/
[1] https://antora.org/
[2] https://github.com/CentOS/docs
[3] https://github.com/CentOS/docs-installation-guide
[4] https://github.com/CentOS/docs-web

_______________________________________________
CentOS-docs mailing list
CentOS-docs@xxxxxxxxxx
https://lists.centos.org/mailman/listinfo/centos-docs



[Index of Archives]     [CentOS]     [CentOS Announce]     [CentOS Users]     [CentOS Virtualization]     [Linux Media]     [Asterisk]     [Netdev]     [X.org]     [Xfree86]     [Linux USB]     [Project Hail Cloud Computing]

  Powered by Linux