add a header for legacy version docs that they are not for current version

[wasaga]

What's incorrect or missing

The user may not necessarily notice that these are not current docs.
We've got users citing legacy version documentation every week, even if they're just starting with pomerium.

What's the resolution?

Add a header that documentation is not for current version, and link to current.

[ZPain8464]

I agree this would be helpful for users, especially if they're unaware they aren't on the latest version.

We could try adding an announcement bar (see below), with text like:

"You are on the Pomerium <vX.XX> docs website. This documentation is outdated. To view the latest documentation, please go to https://pomerium.com/docs."

export default {
  themeConfig: {
    announcementBar: {
      id: 'old_version',
      content:
        'You are on the **Pomerium <vX.XX>** docs website.  This documentation is outdated. To view the latest documentation, please go to https://pomerium.com/docs.'
      backgroundColor: '#fafbfc',
      textColor: '#091E42',
      isCloseable: false,
    },
  },
};

[desimone]

great idea. +1

[kenjenkins]

@desimone, do you have any context on how the older docs sites are hosted? Would we need to restore some of the Git history for the docs site deleted in pomerium/pomerium#3420 in order to make updates to v0.10 through v0.17?

[ZPain8464]

@kenjenkins and @desimone I went ahead and started implementing this, but to Ken's point, the available branches in pomerium/documentation go back to 0-17-0. Beyond that, it's difficult to retroactively add the announcement banner.

[ssveta7ak]

Implemented.