keda-docs icon indicating copy to clipboard operation
keda-docs copied to clipboard

Clarify the KEDA website and documentation maintainers

Open dwelsch-esi opened this issue 1 year ago • 5 comments
trafficstars

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.

dwelsch-esi avatar Apr 15 '24 18:04 dwelsch-esi

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.

stale[bot] avatar Jun 15 '24 16:06 stale[bot]

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

nate-double-u avatar Jun 18 '24 00:06 nate-double-u

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?

tomkerkhove avatar Jun 19 '24 08:06 tomkerkhove

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.

nate-double-u avatar Jun 28 '24 23:06 nate-double-u

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?

tomkerkhove avatar Jul 01 '24 07:07 tomkerkhove