Restructure branches into web and guides (nightly, X.Y, etc) about foreman-documentation

[maximiliankolb]

Instead of duplicating content, can we use curl in GHA and git checkout web my_file for local builds? If this is technically not feasable, I am not against duplicating it. I feel like the css is rarely touched anyway. We can probably get away with an IMPORTANT note in the README and a nice comment in the css files.

+1 for the idea and effort; I think it's definitely the right direction! I see this as a valid intermediate state towards Antora (which we can but don't have to use right away).

also +1 for changing the default branch to "develop" (like foreman) or "nighly" (like our URLs)

[adamlazik1]

I'm OK with all other changes, but I don't see the benefit in renaming master to nightly. Then again, I guess there is not any issue with it either, so I probably wouldn't mind.

[ekohl]

Instead of duplicating content, can we use curl in GHA and git checkout web my_file for local builds? If this is technically not feasable, I am not against duplicating it. I feel like the css is rarely touched anyway. We can probably get away with an IMPORTANT note in the README and a nice comment in the css files.

That's an interesting thought. Given how little they change I'd start with duplicating (given that's what we essentially already have today) and then later revisit dynamic retrieval.

I'm OK with all other changes, but I don't see the benefit in renaming master to nightly. Then again, I guess there is not any issue with it either, so I probably wouldn't mind.

It's to simplify cases like these:

foreman-documentation/.github/workflows/deploy.yml

Lines 91 to 97 in 72097c1

	- name: Set target name (master)
	if: github.base_ref == 'master'
	run: echo "TARGET_NAME=nightly" >> $GITHUB_ENV
	- name: Set target name (stable branch)
	if: github.base_ref != 'master'
	run: echo "TARGET_NAME=$(echo ${GITHUB_BASE_REF} | tr / -)" >> $GITHUB_ENV

foreman-documentation/.github/workflows/deploy.yml

Lines 207 to 210 in 72097c1

	- name: Rename master to nightly
	if: github.ref == 'refs/heads/master'
	run: mv master nightly
	working-directory: ./public

foreman-documentation/web/content/404.html.erb

Line 10 in 72097c1

.replace("/master/", "/nightly/")

Essentially make the branch map 1:1 to the target.

[adamlazik1]

Works for me.