From 4bc1fb5e4f0841b7e598e848fdb9c604d3517937 Mon Sep 17 00:00:00 2001
From: Yax <1949284+kianby@users.noreply.github.com>
Date: Sat, 5 Nov 2022 11:47:56 +0100
Subject: [PATCH] Enhance documentation

---
 README.md | 25 ++++++++++++-------------
 1 file changed, 12 insertions(+), 13 deletions(-)

diff --git a/README.md b/README.md
index d1ce097..3e53421 100644
--- a/README.md
+++ b/README.md
@@ -1,19 +1,18 @@
-# dotfiles
+# My dot files managed by [ChezMoi](https://github.com/twpayne/chezmoi)
 
-My dot files managed by ChezMoi (https://github.com/twpayne/chezmoi)
+## My friend programs
 
-Friend tools:
-- bash
-- tmux, tmuxp, tpm
-- tig, git
-- starship
-- vim or neovim, vundle
-- python
-- perl
-- sdkman
-- fzf
+- shell interpreter : bash and the prompt manager starship
+- terminal multiplexer: tmux, tmuxp, tpm
+- a swiss-knife to make life easier: [fzf](https://github.com/junegunn/fzf)
+- git: configuration and the terminal manager [tig](https://jonas.github.io/tig/) 
+- vim: vim or neovim, [vundle](https://github.com/VundleVim/Vundle.vim)
+- languages: python, perl, java with [sdkman](https://sdkman.io/) 
 
-Configuration file *~/config/chezmoi/chezmoi.toml*
+
+## Configuration file
+
+a sample file (located in *~/config/chezmoi/chezmoi.toml*)
 
 ```toml
 [data]