Skip to content

Documentation for the Foreman Project and its ecosystem

Notifications You must be signed in to change notification settings

suyogsainkar/foreman-documentation

 
 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Foreman documentation

THIS IS A WORK IN PROGRESS, VISIT OFFICIAL FOREMAN OR KATELLO DOCUMENTATION IF YOU ARE SEEKING HELP.

This git repository contains PoC of improving Foreman documentation.

Foreman Guides

This is a tree of documentation based on Red Hat Satellite 6 official books. See README in the guides/ subdirectory for more information.

Static Site

Landing page for docs.theforeman.org is available as a Hugo project. See README in the web/ subdirectory for more information.

Deployment

Github actions perform HTML (with link validation), PDF and WEB artifact creation and if suceeded and branch is master or stable, artifacts are downloaded, extracted and deployed (commited into gh-pages). Deployment does not delete files, in order to remove some unwanted content, manual deletion and push into gh-pages must be performed.

When a commit is pushed into master:

  • All artifacts are built.
  • Static WEB and HTML is downloaded and copied into / or /nightly respectively.
  • Changes are pushed into gh-pages branch.

When a commit is pushed into X.Y:

  • All artifacts are built.
  • HTML artifact is downloaded and copied into /X.Y.
  • Changes are pushed into gh-pages branch.

Branching new release

  • Create new directory /web/content/version-X.Y and copy index.md and edit it accordingly.
  • Edit /web/content/versions.md and add the new version to the menu.
  • Push the changes into master.
  • Check the site if links and landing page appeared correctly.
  • Create new X.Y branch.
  • Update attributes.adoc: DocState, Version attributes
  • Push into X.Y branch.
  • HTML guildes should be deployed into /X.Y
  • Update attributes.adoc in old version to "unsupported".

License

See LICENSE files in individual subdirectories

About

Documentation for the Foreman Project and its ecosystem

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • CSS 85.2%
  • HTML 5.5%
  • Ruby 3.1%
  • SCSS 2.8%
  • Makefile 2.2%
  • JavaScript 0.6%
  • Shell 0.6%