#74 team directory prototype
Merged by bcotton. Opened by asamalik.
Fedora-Council/ asamalik/council-docs team-directory  into  master

Implementing https://pagure.io/Fedora-Council/tickets/issue/295

Let me explain what I did:

I've copied the sources of the two following pages to this repo:
* Mindshare Teams
* Engineering Teams

... we'll reuse those as the team directories. When we're ready, I switch the docs to use these sources instead of the original ones for these pages.

Added a file TEMPLATE_team_info.adoc — a template of a data store for each team's information. Each team will store their own copy either in their docs git, or here or somewhere if they don't have one. Council representatives then include those in the pages. There are examples in the sources already, but each entry will look like this:

// The Template Team
include::mindshare:ROOT:partial$TEMPLATE_team_info.adoc[]
include::partial$team_render.adoc[]

The file team_renderer.adoc defines how each entry is rendered.

Teams will be also able to include their data store on any page, and use {team_name}, {team_description}, etc. wherever they want to.

Not sure if it's not too complicated. As an alternative, we could also just keep the format of the team pages as it is right now, and just make sure the council representatives keep them up-to-date.

What do people think?

I like the general concept. My main concern is that we have the template duplicated in two places, which means if we ever want to change it we have to change it in two places. I wonder if we'd be better off having a canonical location that the instructions say (copy this from). Or maybe I'm worrying about a problem that won't really be much of a problem.

I'd also suggest adding the basics of the communication channels to the team_render.adoc so that folks can see it at a glance.

I'm interested to see what others think as well.

Is there a screenshot of what this looks like without running it locally? Curious what it looks like but not near my dev environment right now.

rebased onto ef4b873cec9a6bf16cb75d16c8cdec8ef8ceba06

Is there a screenshot of what this looks like without running it locally? Curious what it looks like but not near my dev environment right now.

See https://pagure.io/Fedora-Council/tickets/issue/295#comment-660564

During the Council Face-to-Face: #agreed We will start using the proposed team directory tooling (+9,0,-0)

Merging this PR

Pull-Request has been merged by bcotton