Updating menu and many other things

[bennyvasquez]

What started as a simple plan to add a few new files to the menu became a much bigger undertaking

• Finding the different groups of articles that were all listed under "series" was causing us to miss out on both SEO and general usability, so I moved them into the main "Documentation" part of the menu.
• I moved the articles that Tristan recently contributed to their own folder targeted at Desktop setup
• I moved the NVIDIA driver documentation to its own folder, to make it easier to find.
• I smoothed out formatting of the code to make it more consistent between files (for example, adding titles to all the files I touched, adding Intros where there weren't any, adding or removing # where necessary to be consistent between articles, etc.

[bennyvasquez]

This needs another set of eyes from someone who's been VERY active in our documentation. Might be best to wait 'till @sboldyreva is back from vacation, unless @andrewlukoshko feels comfortable giving it a review.

[sboldyreva]

@bennyvasquez I got so confused with the new structure related to AlmaLinux Tutorials and System Series. The updates tell me that these are two separate sub-sections, but the AlmaLinux Tutorial README looks like nginx, system, nvidia, and desktop should be subsections under AlmaLinux tutorials. Could you please take one more look?

[sboldyreva]

@bennyvasquez I get a feeling that all the emojis in headings look a bit off our style. I think we better first define their correct usage before placing them there. As currently some pages containt emojies, some contain them only in some headings but not in every heading. Looks a bit like a mess to me.

Also while looking through the pages I notices the inconsistency in some "Steps/lists", for ex in Desktop Series.We would typically desing these steps as a bullet list, but this time they are headings. Should we unify the format there?

[bennyvasquez]

Sonya and talked through this yesterday and decided we're doing this:

• Get rid of the numbering system
  • in the names of the articles themselves
  • in the links to the articles
  • in the menu
• Drop the multiple 9.x versions
  • remove links to NginxSeriesA02R91
• Emojis in the section titles
  • let's drop them for nwo
• remove the "this article" lines
• consolidate the 9.1 and 9.2 nginx guides into a single 9.x guide

I'm working on all of these now!

[bennyvasquez]

@sboldyreva this one's ready for you again!

[sboldyreva]

I am not sure I understand the designed structure here. This README lists all possible tutorials/series/guides even if they are not in AlmaLinux Tutorials section

A few questions here in this case:

• There's a category of tutorials that are listed here - "System series" and only they are in "AlmaLinux Tutorials - but in the side-menu they are not under System series
• I can see LAMP server tutorial in the side-menu but it's not listed here?

[sboldyreva]

- [Deploy a LAMP server](/series/LAMP-server)

[sboldyreva]

Should we move this line to the end of the page right before trademark notice?

[sboldyreva]

There's a Variant III heading above that has an emoji left

[sboldyreva]

this list looks a bit confusing for me

can we split it like something like:

These guides provide instructions:
- NVIDIA on AlmaLinux Overview [NVIDIA Drivers Guide for AlmaLinux](/series/nvidia/)
- NVIDIA Driver Installation Guide ❯ [Installation on 8.x](/series/nvidia/nvidiaseries8x)
- NVIDIA Driver Installation Guide ❯ [Installation on 9.x](/series/nvidia/nvidiaseries9x)

Each guide provides steps to install NVIDIA's driver in 3 different ways:
- Option I: Precompiled/Binary Driver - using precompiled drivers is recommended.
- Option II: Compile Driver Source - requires switching to an ELRepo kernel.
- Option III: NVIDIA .run Driver Installation Guide - requires manual installation of dependencies and downloading the driver manually from Nvidia website

[sboldyreva]

@bennyvasquez a few more things! overall it look good for now :)