Re: Team directory docs

Hello,

On Wed, Aug 26, 2020 13:43:02 -0400, Ben Cotton wrote:
> (Note that this is not yet linked from anywhere else. That will happen
> once we're relatively settled with the content)

Like the "subprojects documentation" link on the org-chart page?

https://docs.fedoraproject.org/en-US/project/orgchart/

I like the idea of having a central location for information on teams,
but I'm always wary of the usual issue with lots of documentation: the
same information being written on multiple pages without a clear
indication of which copy is considered the authoritative copy. Consider:

- someone searches for $team on $searchsite
- they get as their results: wiki page for the team, perhaps docs pages,
and the council teams page.

If any of these pages have different information, the individual must
decide on which information to follow. So, we need to do something to
indicate that the council teams page (and docs in general?) is to be
trusted more than other pages. Whether this is through SEO to ensure
that it is listed before other results, or through notes on wiki pages
saying "trust the docs more than you trust the wiki", or another method
needs to be decided.


On a loosely related note, having search on docs would be really nice.
It's still a major usability issue:
https://pagure.io/fedora-docs/docs-fp-o/issue/2

--
Thanks,
Regards,
Ankur Sinha "FranciscoD" (He / Him / His) | https://fedoraproject.org/wiki/User:Ankursinha
Time zone: Europe/London