We already have the following pages:

• Engineering: https://docs.fedoraproject.org/en-US/engineering/
• Mindshare: https://docs.fedoraproject.org/en-US/mindshare/

I'll reuse those two, and add one more for Diversity and Inclusion.

Their sources are currently in the fedora-docs/pages repository, but I'll move them to the Fedora-Council/council-docs repository, so the right people (Engineering, Mindshare, and D&I representatives) get the correct permissions automatically. This move won't affect the website in any way btw, it's just a source change.

Then, I'll create a template for entries for each team. There are two approaches on storing these entries:

1. Each team will be able to put their entry anywhere within their docs, so they can maintain it. And those entries then get included in the Engineering, Mindshare, and D& pages.

2. All entries will be on a single place, maintained by the respective Council representative.

I think option 1 is what we want, right?

I think option 1 is what we want, right?

That would be preferred, this way it can be reused within the team's own docs if desired. The appropriate Council rep would add or remove includes (or whatever the specific mechanism) as teams pop up or go zombie.

Cool!

I need to check if there is a way to define all those fields at one place, but include just a subset in the directory.

So, this might be a hack, but I've figured it out!

We can have files with variables representing the individual team entries. Then, there is a 'rendering template' — a file that defines how those (and which) variables get rendered.

That's then put on a page as a series of include statements. It'll work across multiple repos, too.

Example:

Team definitions

team1.adoc:

:team_name: Team one
:team_description: We're just fantastic.

team2.adoc:

:team_name: Team two
:team_description: Nope, we're better!

A 'rendering template'

template.adoc:

== {team_name}

{team_description}

The directory page

include::partial$team1.adoc[]
include::partial$template.adoc[]

include::partial$team2.adoc[]
include::partial$template.adoc[]

Opened a PR: https://pagure.io/Fedora-Council/council-docs/pull-request/74

PR merged. Will open tickets for area reps to fill in the details