baa

Author: Alexia Michelle

docs/nvidia-drivers.md

@@ -4,6 +4,43 @@ sidebar_position: 4
 
 # NVIDIA Driver Installation
 
-This guide will cover the installation of NVIDIA proprietary drivers on GoldenDog Linux.
+Unlike AMD or Intel, NVIDIA does not open-source its drivers to the Linux kernel or distributions. As a result, NVIDIA drivers are always proprietary, regardless of which distribution you use.
 
-*(Content coming soon... In the meantime, you can use the official Debian non-free repositories to install `nvidia-driver`.)*
+## Why Use Repository Packages?
+
+The binary provided by NVIDIA on their official website is essentially the same as the one found in the Debian/GoldenDog `nvidia-driver` package. However, installing it through the official repositories offers a massive advantage: **Stability during updates.**
+
+### The "Manual Install" Trap
+If you install the driver manually using a `.run` file from NVIDIA's website:
+1. The driver compiles a kernel module specifically for your **current** kernel version.
+2. When GoldenDog/Debian updates the kernel, that module becomes invalid.
+3. Your system may fail to boot into a graphical session until you manually recompile the driver.
+
+By using the repository package, the system uses **DKMS** to automatically recompile the driver module every time a new kernel is installed.
+
+:::danger DO NOT INSTALL MANUALLY
+We strongly recommend **against** installing NVIDIA drivers using the `.run` files from NVIDIA's website. It is the leading cause of system breakage after updates.
+:::
+
+## Installation Guide
+
+### Option 1: The Latest Features (Backports)
+For users who want the best performance, the latest driver features, and better support for **Wayland**, we recommend using the backports repository. This ensures you have both the latest kernel and the latest compatible driver.
+
+```bash
+sudo apt -t trixie-backports install nvidia-driver linux-image-amd64 linux-headers-amd64 -y
+```
+
+### Option 2: The Stable Version
+If you prefer to stay on the standard stable version (fully tested and updated alongside your current kernel), run:
+
+```bash
+sudo apt install nvidia-driver
+```
+
+## Post-Installation
+After the installation completes, restart your computer to load the new drivers.
+
+```bash
+sudo reboot
+```

i18n/es/docusaurus-plugin-content-docs/current/nvidia-drivers.md

@@ -4,6 +4,43 @@ sidebar_position: 4
 
 # Instalación de Controladores NVIDIA
 
-Esta guía cubrirá la instalación de los controladores propietarios de NVIDIA en GoldenDog Linux.
+A diferencia de AMD o Intel, NVIDIA no abre su código ni al kernel de Linux ni a ninguna distribución. Por lo tanto, el controlador de NVIDIA es siempre **privativo**, sin importar la distribución que utilices.
 
-*(Contenido próximamente... Mientras tanto, puedes usar los repositorios oficiales non-free de Debian para instalar `nvidia-driver`.)*
+## ¿Por qué usar los paquetes del repositorio?
+
+El binario que se descarga de la página oficial de NVIDIA es esencialmente el mismo que se ofrece en el paquete `nvidia-driver` de Debian/GoldenDog. Sin embargo, instalarlo desde los repositorios oficiales ofrece una ventaja crucial: **Estabilidad durante las actualizaciones.**
+
+### La trampa de la "Instalación Manual"
+Si instalas el controlador manualmente usando un archivo `.run` del sitio de NVIDIA:
+1. El instalador compila un módulo del kernel específicamente para tu versión de kernel **actual**.
+2. Cuando el sistema actualiza el kernel, ese módulo deja de ser válido.
+3. El sistema podría fallar al iniciar la sesión gráfica hasta que recompiles manualmente el controlador.
+
+Al usar el paquete del repositorio, el sistema utiliza **DKMS** para recompilar automáticamente el módulo del controlador cada vez que se instala un nuevo kernel.
+
+:::danger NO INSTALAR MANUALMENTE
+No se recomienda bajo ningún concepto instalar el controlador NVIDIA utilizando los archivos `.run` descargados fuera de la distribución. Esta es la causa principal de fallos en el sistema tras una actualización.
+:::
+
+## Guía de Instalación
+
+### Opción 1: Lo más reciente (Backports)
+Para los usuarios que buscan el mejor rendimiento, las funciones más recientes del controlador y un mejor soporte para **Wayland**, recomendamos utilizar el repositorio de *backports*. Esto garantiza que tengas tanto el kernel más reciente como el último controlador compatible.
+
+```bash
+sudo apt -t trixie-backports install nvidia-driver linux-image-amd64 linux-headers-amd64 -y
+```
+
+### Opción 2: Versión Stable
+Si prefieres mantenerte en la versión estable estándar (probada y actualizada siempre junto con tu kernel actual), ejecuta:
+
+```bash
+sudo apt install nvidia-driver
+```
+
+## Post-Instalación
+Una vez finalizada la instalación, reinicia tu computadora para cargar los nuevos controladores.
+
+```bash
+sudo reboot
+```