Planning for Foreman is now live

Hi Foreman community,

We’ve migrated another guide from Red Hat Satellite to Foreman: Planning for Foreman, available at http://docs.theforeman.org/

This is an introductory guide that explains the architecture, concepts, and options you’ll want to know before installing Foreman and the Katello plug-in.

Check out the guide and feel free to submit feedback and contribute at https://github.com/theforeman/foreman-documentation

3 Likes

Thank you, you guys are on a roll.

I noticed that the guide has two top headlines “Foreman Architecture” and “Foreman Deployment Planning” and these don’t have numbering. Is this intentional? Downstream I do see roman numbers “I” and “II”. It’s a bit misleading, but not big deal.

Yeah, this guide has a lot about Katello, but rather than hiding the stuff we have decided to expose, like for the most of the content in our new guides. All guides are now fully modularized, meaning every single chapter consists of one to several modules (unit of text stored in separate files and included via asciidoc statement). Therefore it’s much easier to create let’s say Foreman without Katello guide containing only the relevant parts.

Thanks!

2 Likes

I noticed that the guide has two top headlines “Foreman Architecture” and “Foreman Deployment Planning” and these don’t have numbering. Is this intentional? Downstream I do see roman numbers “I” and “II”. It’s a bit misleading, but not big deal.

You’re right, that’s a result of the downstream markup, which uses “parts” (the roman numbers). We could either remove those upstream (I don’t think they add a lot of value), or find another way to present them.

2 Likes