Tibs (Tony Ibbs)

Update the terraform README page with corrected names and ® usage

1

The README page for the `terraform` directory needs checking and updating. Known issues are: * In the diagram: * `®` marks are not given for the various products (note: I...

# What should we add to our content collections? The Aiven free plan services are well documented at https://docs.aiven.io/docs/platform/concepts/free-plan That page mentions backups. When I go to specific backup pages,...

Upgrade our version of sphinx so we get docutils 0.19

2

Our current `requirements.txt` specifies sphinx 4.3.2, which implicitly pins docutils to 0.17.1 (for compatibility issues of the time) Docutils stable is now 0.19 - note this requires Python 3.7 or...

Update the "Community" link(s) in the ToC panel

3

We now have a Community page at aiven.io (http://avien.io/community) and should reflect this in the documentation. One possibility is to replace the current "Community" link with a direct link to...

Improve the titles in the `_toc.yml` file (navigation sidebar)

1

## The problem The [`_toc.yml`](https://github.com/aiven/devportal/blob/main/_toc.yml) file is used to generate the navigation sidebar. Some of the page titles in the `_toc.yml` file are specified explicitly in the file, some default...

Migration: Help document 489581 "How do you apply software updates and security patches?"

1

The help article "How do you apply software updates and security patches?" (original URL https://help.aiven.io/en/articles/489581-how-do-you-apply-software-updates-and-security-patches) has not been migrated, and there is a demand for it. Migrate it to the...

We currently have a Vale rule that makes sure that we always use "MirrorMaker 2", and don't allow "MirrorMaker" (see `.github/vale/styles/Aiven/common_replacements.yml`). We *could* consider replacing that with a rule that...

https://github.com/aiven/devportal/issues/939 changed the logo we use for Redis on the documentation front page. Similar work is also changing the logo used in console. We have screenshots in `images/` that still...

The Integrations page on Rsyslog integration should be split up

2

For speed/simplicity of migration, the page at `docs/integrations/rsyslog.rst` gives the documentation for all of the rsyslog integrations, except Datadog, for which it has a link to another page. Ideally, it...

Add linting for "meta" documentation files (README.rst, etc.)

1

We don't apply Vale linting to our "meta" documentation files, specifically: * CONTRIBUTING.rst * README.rst * REVIEWING.rst * .github/vale/README.rst I believe it would be a good idea to do so,...