docs

docs copied to clipboard

Summary Updated docs to include Ubuntu 22.04 LTS. Additionally, fixed an outdated link in 2004 ubuntu postgres docs.

Validated the docs locally on a VM for both postgres and mysql, no issues.

Do not publish / merge until April 21, 2022.

Ticket Link

Fixes https://github.com/mattermost/docs/issues/5362

All reads well. I do wonder, when thinking about support matrix, if we have an opportunity to streamline by cross-referencing content (e.g. db setup section without specific host info).

I agree, it would clean up a ton of the pages and duplicated content right now. Most of the instructions appear to be the same. In the past for RHEL docs we would simply point out when a command is different on a specific version and keep everything together.

I don't know if that something we want to tackle in this PR or know for future?

I agree with you both that streamlining and simplifying our install docs requires us to start pulling back on the level of third-party software support we provide in the product documentation. Every time we include these details, it's information that must be maintained over time, otherwise we risk frustrating our users with inaccurate instructions.

@coltoneshaw - You seriously did a beautiful job of following our current install docs approach. Well done! @nab-77 - What is your recommendation on how to move forward with this PR specifically, given that we all agree that we need to scale back the third-party support content?

My recommendation: Since we need to wait for the release of 22.04 to publish this update, we don't need an immediate decision. I'm inclined to publish this great content that Colton was kind enough to develop as-is, with an understanding that we'll revisit this content later this year with a streamlining goal in mind.

@cwarnermm - I almost forgot about this. Are we go to merge this?

@coltoneshaw - Yes! Looks like 22.04 is now released, so we should finalize this PR. @nab-77 - Given our intention to continue simplifying our installation instructions overall, how would you like to proceed with this PR specifically?

We should push this out as it's a case of us updating for the latest/greatest Ubuntu.

@cwarnermm - I removed the do not merge label and it's passing the checks. If you're okay to merge this we can move it forward!

Newest code from cwarnermm has been published to preview environment for Git SHA 0ef12447eb5cd6c85f11a4f08829237681782d1f

Thanks, @coltoneshaw! To merge this PR, we need to address the one Ubuntu installation docs link (that doesn't yet exist).

@cwarnermm - You just mean adding the link? I'm not sure i'm following

Hi @coltoneshaw! I'm unable to find a link to the 22.04 installation guide. The URL referenced in these docs https://help.ubuntu.com/22.04/installation-guide/amd64/index.html doesn't resolve as-is (though the 20.04 version is available). Is there an alternate resource we could point admins to for installation guidance instead?

@cwarnermm OHH. I actually don't think they published it yet. https://help.ubuntu.com/ all the server 22.04 links point to 20.04. They must not have a docs team as good as us.

The command GRANT ALTER, CREATE, DELETE, DROP, INDEX, INSERT, SELECT, UPDATE, REFERENCES ON mattermost.* TO 'mmuser'@'%'; didn't work for me.

I had to resort to using ALL. I guess some privileges are still missing from the above command used in Mattermost 7.0.2 and up.

This also needs to be updated for other guides as well.

@cwarnermm, could we merge this as-is or does it need more review?

There are 2 things outstanding for this PR:

• merge conflicts need to be resolved (@coltoneshaw)
• the Ubuntu v22.04 installation guide documentation needs to be published.

@cwarnermm - I don't think we'll get the installation guide, they haven't posted it yet (a year later). I also now question if we even need to link to installing an OS. That feels like a really low level step, the sysadmin should know how to do... but can also google really easily. The docs we previously linked to were long and honestly, not super useful for the target audience of the link (people who don't know already how to install an OS). Take a look yourself and see if in 5 minutes you can find how to install Ubuntu 20.04 - https://help.ubuntu.com/20.04/installation-guide/amd64/install.en.pdf. I know I couldn't.

Second, I haven't touched this since our past talks, docs like this will be deprecated. I'm happy to update anything left.

@coltoneshaw - I agree with you that our install docs content isn't meeting our target audiences where they are yet.

I'm going to close this docs PR in favor of the in-progress platform-based installation approach, where a given platform page clearly notes the versions that Mattermost supports.