PR#91: Hook up the new fesco-docs repo - fedora-docs/docs-fp-o

fedora-docs / docs-fp-o

#91 Hook up the new fesco-docs repo

Closed 5 years ago by asamalik. Opened 5 years ago by zbyszek.

fedora-docs/ zbyszek/docs-fp-o move-fesco into master

Hook up the new fesco-docs repo

Zbigniew Jędrzejewski-Szmek • 5 years ago

daf4432

pages/modules/ROOT/pages/index.adoc

file modified

+2 -2

		`@@ -50,9 +50,9 @@`
		`</a>`
		`</div>`
		`<div class="homepage-section-container">`
		`- <a href="../fesco/teams/" class="homepage-link homepage-link-primary">`
		`+ <a href="../fesco/" class="homepage-link homepage-link-primary">`
		`<h3>Engineering Teams</h3>`
		`- <p>Learn about FESCo and Engineering subprojects, SIGs, Work Groups, and teams.</p>`
		`+ <p>FESCo membership and policies, Engineering subprojects, SIGs, Work Groups, and teams.</p>`
		`</a>`
		`<a href="../mindshare/teams/" class="homepage-link homepage-link-primary">`
		`<h3>Mindshare Teams</h3>`

site.yml

file modified

+2 -2

		`@@ -46,10 +46,10 @@`
		`branches:`
		`- master`
		`start_path: project`
		`- - url: https://pagure.io/Fedora-Council/council-docs.git`
		`+ - url: https://pagure.io/fesco/fesco-docs.git`
		`branches:`
		`- master`
		`- start_path: fesco`
		`+ start_path: fesco/`
		`- url: https://pagure.io/Fedora-Council/council-docs.git`
		`branches:`
		`- master`

zbyszek commented 5 years ago

See https://pagure.io/fesco/issue/1994.

asamalik commented 5 years ago

Nice to see FESCo moving to the docs!

Happy to move FESCo under its own source repo. We just need to make sure that the "Technical Teams" page continues working as it does now as it's the only pointer to sections such as Modularity or Flatpak.

Also, we've decided that this "Technical Teams" page should be linked directly from the homepage, so it's easier to find the sub-teams. https://lists.fedoraproject.org/archives/list/docs@lists.fedoraproject.org/thread/CVYWR77ENCB54HZXIFFPNZNPSLGL2Y4Z/

Looking at the FESCo docs source repo, the page is missing. Could you add it?

rebased onto daf4432

5 years ago

zbyszek commented 5 years ago

Updated.

asamalik commented 5 years ago

Thanks, I'll have a look at this ASAP, very likely today.

asamalik commented 5 years ago

The "Engineering Teams" page is missing. I see you've listed Modularity in the menu on the left — currently the only link under the "Engineering Teams" in the menu left. While that technically works, it makes the user experience inconsistent and confusing, because instead of just showing another page as all of the other links to, it jumps to a completely different component in the docs. That's why we had the "Engineering Teams" page there. I can't just merge it without the page.

Also, this PR still changes the homepage link from "Engineering Teams" to "FESCo". This also prevents me from merging it.

@zbyszek Are you OK with those two changes I'm requesting? I'm happy to discuss.

asamalik commented 5 years ago

@zbyszek So we've just discussed a similar thing for Mindshare with @bex and I think we've came up with a way to make everyone happy. It looks like there is no need to do anything for you at this moment, the FESCo docs should be usable as they are.

I won't merge this PR because we need to do it a bit differently, but I'll accomplish what you're asking for.

asamalik commented 5 years ago

It's now added, even though a bit differently than this PR. https://docs.fedoraproject.org/en-US/fesco/