refactor: simplify dotfiles configuration

README.md

@@ -1,19 +1,77 @@
 # Dotfiles
-All kind of dot files
 
-## Installation
+Focused Vim 9, Bash, and tmux configuration for Linux, WSL, and macOS. The
+Windows installer manages the same Vim configuration.
 
-### Linux, \*nix, Mac OSX Installation
+## Requirements
 
-Simply copying and pasting the following line into a terminal.
+- Git
+- Vim 9 or newer
+- `curl` for the Unix installer
+- Optional: tmux, zoxide, ripgrep, and a Nerd Font
+
+## Install
+
+Clone the repository, then install all components:
 
 ```bash
-    curl https://raw.githubusercontent.com/Donaldttt/dotfiles/main/install.sh -L > dotfiles_install.sh && sh dotfiles_install.sh
+git clone https://github.com/Donaldttt/dotfiles.git ~/.dotfiles
+~/.dotfiles/install.sh
 ```
 
-or
+Components can be installed independently and combined:
 
 ```bash
-    sh <(curl https://raw.githubusercontent.com/Donaldttt/dotfiles/main/install.sh -L)
+~/.dotfiles/install.sh vim
+~/.dotfiles/install.sh shell tmux
 ```
 
+The installer backs up conflicting files, creates managed links, and installs
+Vim plugins and TPM. It never updates an existing repository automatically and
+does not install zoxide; if zoxide is already available, the managed Bash block
+initializes it.
+
+On Windows, clone the repository and run:
+
+```powershell
+python .\win-install.py
+```
+
+## Vim
+
+The Vim setup includes Fuzzbox and NERDTree navigation, Fugitive and GitGutter,
+Startify, a compact global statusline, and five color schemes.
+
+Useful mappings use `,` as the leader key:
+
+- `,ff`: files
+- `,fg`: text search
+- `,e`: NERDTree
+- `,cbg`: light/dark mode
+- `,ctb`: transparency
+- `:FuzzyColors`: choose a color scheme
+
+Plugin maintenance is explicit:
+
+```vim
+:PlugUpdate
+:PlugClean
+```
+
+## Update and uninstall
+
+Update safely from a clean worktree:
+
+```bash
+git -C ~/.dotfiles pull --ff-only
+~/.dotfiles/install.sh
+```
+
+To remove managed links and the managed Bash block:
+
+```bash
+~/.dotfiles/uninstall.sh
+```
+
+Uninstalling intentionally retains the repository, backups, Vim data/plugins,
+and TPM so user data is never removed implicitly.