What are the CachyOS repositories rework (#57)

* Restructured and updated content

* Final touches

* Update src/content/docs/cachyos_repositories/what_are_the_cachyos_repo.md

Not wrong

Co-authored-by: Eric Naim <dnaim@cachyos.org>

* Update src/content/docs/cachyos_repositories/what_are_the_cachyos_repo.md

I like the way you think

Co-authored-by: Eric Naim <dnaim@cachyos.org>

* Change language used in code block

Still follows md040 guidelines while keeping the suggested look

* Update src/content/docs/cachyos_repositories/what_are_the_cachyos_repo.md

Co-authored-by: Eric Naim <dnaim@cachyos.org>

* Add mention of backported fixes

* Add Zen 5

---------

Co-authored-by: Eric Naim <dnaim@cachyos.org>

Author: Aarrayy

src/content/docs/cachyos_repositories/what_are_the_cachyos_repo.md

@@ -1,31 +1,45 @@
 ---
 title: CachyOS Repository General Information
-description: Benchmarks and information about the repository
+description: Benchmarks and information about our optimized repositories
 ---
 
-# Why does CachyOS utilize its own repositories?
+Our aim to deliver a performance-optimized distribution necessitates recompiling essential Arch Linux packages for generic x86-64,
+x86-64-v3, x86-64-v4, and Zen4 architectures.
 
-## Performance and optimizations
-We want to provide a performance-optimized distribution and this requires performance-optimized packages. Currently we are recompiling the Arch Linux repository core and extra with the generic x86-64-v3 and x86-64-v4 instruction set.
+- x86-64 (Most CPUs) - While lacking AVX2 support found in x86-64-v3, this repository offers optimized packages. LTO and PGO techniques have boosted performance in several packages.
+- x86-64-v3- (Intel Haswell and up, AMD Ryzen 1st gen and up) - 5%-20% performance uplift compared to x86-64.
+- x86-64-v4 (Intel Rocket Lake, Zen 4, Zen 5) - Delivers substantial performance gains through AVX512 support, depending on the workload.
+- Zen 4/5 - In addition to the x86-64-v4 instruction set, the following are added:
 
-- x86-64-v4 - Enabling AVX512 can significantly improve application performance (Depending on the application/workload)
-- x86-64-v3 - *5%-20% performance uplift*
+```text
+abm, adx, aes, avx512bf16, avx512bitalg, avx512ifma, avx512vbmi, avx512vbmi2, avx512vnni,
+avx512vpopctndq, clflushopt, clwb, clzero, fsgsbase, gfni, mwaitx, pclmul, pku, prfchw,
+rpdid, rdrnd, rdseed, sha, sse4a, vaes, vockmulqdq, wbnoinvd, savec, xsaveopt, xsaves
+```
 
-## Customized Packages
+Check out [this](https://en.wikipedia.org/wiki/X86-64#Microarchitecture_levels) page for more information about the instructions used in the different x86_64 micro-architectures
 
-In the [CachyOS-PKGBUILDs](https://github.com/CachyOS/CachyOS-PKGBUILDS) repository we are maintaining a bunch of packages, which are constantly getting patches. PGO or BOLT Optimization to provide an additional uplift in performance.
+:::note
+Wikipedia page quotes that the Skylake architecture supports AVX512 which is wrong, only Skylake-X does.
+:::
 
-# Tests and benchmarks
-If you would like to know more about the performance uplift from our repositories. Please see the links below.  
+### Customized Packages
 
-- Phoronix has already benchmarked Cachy twice and it seems to be a win for CachyOS, which is shown mostly leading in the benchmark graphs and on the Geometric Mean of All Test Results. 
-These benchmarks are old by now, After these two reviews, CachyOS evolved and matured a lot more in terms of usability and performance. the following review was the first one Michael made of CachyOS on it's infancy.  
+Our [CachyOS-PKGBUILDs](https://github.com/CachyOS/CachyOS-PKGBUILDS) repository contains packages that receive ongoing updates, patches and backported fixes.
+To boost performance, we selectively implement PGO, LTO, and BOLT optimizations depending on the need.
+We also maintain a couple of -git packages e.g mesa-git.
+
+### Tests and benchmarks
+
+If you would like to know more about the performance uplift from our repositories. Please check the links below.
+
+- Phoronix has already benchmarked CachyOS twice and it seems to be a win for CachyOS, which is shown mostly leading in the benchmark graphs and on the Geometric Mean of All Test Results.
+These benchmarks are old by now, After these two reviews, CachyOS has evolved and matured a lot more in terms of usability and performance. the following review was the first one Michael made of CachyOS on it's early days.
 https://www.phoronix.com/review/cachyos-linux-perf
 
 - Here, Phoronix has recently conducted another benchmark demonstrating the difference between x86-64-v4, x86-64-v3 and x86-64 (generic) Packages. Looking at the examples like PHP or GCC, where we customize our PKGBUILDs there is a noticeable performance improvement.
 https://www.phoronix.com/review/cachyos-x86-64-v3-v4
 
-
-- x86-64-v3 (- there is a moderate benefit of *-march=haswell* (x86_64-v3) - of around
-10%-20% as compared to baseline for the tests performed by Arch Linux):  
-https://lists.archlinux.org/pipermail/arch-general/2021-March/048739.html
+- x86-64-v3 (there is a moderate benefit of *-march=haswell* (x86_64-v3) - of around
+10%-20% as compared to baseline for the tests performed by Arch Linux):
+https://lists.archlinux.org/pipermail/arch-general/2021-March/048739.html