search

kedacore / keda-docs

Documentation and landing page for KEDA
https://keda.sh
Apache License 2.0
113 stars 421 forks source link

Clarify the KEDA website and documentation maintainers #1372

Open dwelsch-esi opened 2 months ago

dwelsch-esi commented 2 months ago

Document the website maintainers.

Use-Case

Documentation and website maintainers should be listed in the doc repository.

Specification

Create an OWNERS.md file to document (on the kedacore/keda-docs repo) the current custodian(s) of the following accounts: analytics (GA4), site-search (Algolia).

Explicitly document in the repo (keda-docs, keda, or both) who the website/documentation maintainers are. Solicit maintainers and contributors for documentation, either in the new OWNERS file or the governance MAINTAINERS file.

stale[bot] commented 3 weeks ago

This issue has been automatically marked as stale because it has not had recent activity. It will be closed in 7 days if no further activity occurs. Thank you for your contributions.

nate-double-u commented 3 weeks ago

It's best not to auto-delete this issue; it is still relevant.

tomkerkhove commented 2 weeks ago

Hi, what would be the recommendation? We already have https://github.com/kedacore/keda-docs/blob/main/.github/CODEOWNERS.

Is the suggestion to reference this in the README or?

nate-double-u commented 1 week ago

I think including the info in the README could work, but I think the point of this suggestion is to ensure access to these services when project personnel changes (or when someone needs access years in the future after things have been setup). Since it's potentially private or secure data, maybe create a private document (shared with the CNCF) with instructions on how to access it when needed.

tomkerkhove commented 1 week ago

Oh I missed the part for site-search & analytics. I honestly don't know that, this was set up by CNCF so I'd presume that is on your team then or not?