upgrade a lot of things (#393)

Author: sb2nov

docs/apps/index.md

@@ -7,9 +7,18 @@ Here is a list of apps that are generally good to use and can come in handy in d
 
 ## Development Tools
 
+- [Brave Browser](https://brave.com/): A privacy-focused browser built on Chromium with built-in ad blocking and full Chrome DevTools.
 - [Google Chrome](https://www.google.com/intl/en/chrome/browser/): Chrome is a developer friendly browser with powerful development tools built in to it.
+- [Warp](https://www.warp.dev/): A modern terminal built on Rust with AI-powered command suggestions and collaborative features.
+- [Cursor](https://www.cursor.com/): An AI-powered code editor built on VS Code.
+- [Zed](https://zed.dev/): A high-performance code editor built in Rust with real-time collaboration.
+- [GitHub Desktop](https://desktop.github.com/): A GUI for Git that simplifies your development workflow.
 - [Valentina Studio](http://www.valentina-db.com/en/valentina-studio-overview): Valentina Studio is a GUI to create, administer and query MySQL, Postgres and SQLite databases.
-- [Atom](https://atom.io/): An open source editor built and maintained by GitHub, is very similar to Sublime Text in most aspects.
+
+## AI Tools
+
+- [Claude](https://claude.ai/): Anthropic's AI assistant desktop app.
+- [Claude Code](https://docs.anthropic.com/en/docs/claude-code): An agentic coding tool from Anthropic that lives in your terminal.
 
 ## Diff and Merge Tools
 
@@ -33,33 +42,34 @@ Here is a list of apps that are generally good to use and can come in handy in d
 
 - [P4Merge](http://www.perforce.com/product/components/perforce-visual-merge-and-diff-tools)
 - [DiffMerge](http://www.sourcegear.com/diffmerge/)
+
 Both of these tools can't compare in terms of features and user interface with their commercial competitors - but make for a valid alternative on Mac, Windows and Linux.
 
 ## Productivity
 
-- [1Password](https://1password.com): Cross platform password management tool.
-- [Airmail](http://airmailapp.com/): Lightweight fast email client.
-- [Alfred](http://www.alfredapp.com/): Spotlight on steroids.
+- [1Password](https://1password.com/): Cross platform password management tool.
+- [Raycast](https://www.raycast.com/): An extendable launcher and productivity tool. A modern alternative to Spotlight and Alfred.
 - [Amphetamine](https://apps.apple.com/us/app/amphetamine/id937984704): Stops the machine from going into sleep mode.
-- [AppCleaner](http://www.freemacsoft.net/appcleaner/): Uninstall apps.
-- [DoubleTwist](https://www.doubletwist.com/desktop/): Import your playlists, ratings, music and videos. Create new playlists to your heart's content. Rate your songs and videos. Play your music and videos and view all of your photos.
+- [AppCleaner](http://www.freemacsoft.net/appcleaner/): Uninstall apps cleanly.
 - [Dropbox](https://www.dropbox.com/): File syncing to the cloud. It syncs files across all devices (laptop, mobile, tablet), and serves as a backup as well!
-- [F.lux](https://justgetflux.com/): f.lux makes the color of your computer's display adapt to the time of day, warm at night and like sunlight during the day (If you are running macOS 10.12.4 or later there's native functionality called 'Night Shift' that does the same thing as f.lux, see System Preferences -> Displays -> Night Shift).
 - [Google Drive](https://drive.google.com/): File syncing to the cloud too! Google Docs is a popular tool to collaborate with others.
-- [Notebooks](http://www.notebooksapp.com/mac/): Notebooks for Mac allows you to share files with the mobile versions of Notebooks on the iPad and iPhone. And you can write notes in markdown.
-- [PDF Toolkit+](https://itunes.apple.com/us/app/pdf-toolkit-+/id545164971?mt=12): App to cut/split/merge pdfs easily. Really easy to use and works well.
-- [Pocket](https://getpocket.com): Save For Later. Put articles, videos or pretty much anything into Pocket. Save directly from your browser or from apps like Twitter, Flipboard, Pulse and Zite.
 - [Rectangle](https://github.com/rxhanson/Rectangle): Don't waste time resizing and moving your windows. Rectangle makes this very easy and is open source.
+- [Shottr](https://shottr.cc/): A small, fast, and feature-rich screenshot tool for Mac.
+- [Pocket](https://getpocket.com): Save For Later. Put articles, videos or pretty much anything into Pocket.
 - [Timing](http://timingapp.com/): Keep track of the time you spend with your Mac.
-- [Tomighty](https://tomighty.github.io/): A free desktop timer for the Pomodoro Technique.
-- [Total Finder](http://totalfinder.binaryage.com/): Adds tabs and improves the Finder to a great deal.
 - [Transmission](http://www.transmissionbt.com/): A fast, easy and free BitTorrent client.
-- [Unarchiver](http://wakaba.c3.cx/s/apps/unarchiver.html): Compress/Uncompress app. Supported file formats include Zip, Tar-GZip, Tar-BZip2, RAR, 7-zip, LhA, StuffIt and many other old and obscure formats.
+- [Unarchiver](https://theunarchiver.com/): Compress/Uncompress app. Supported file formats include Zip, Tar-GZip, Tar-BZip2, RAR, 7-zip, LhA, StuffIt and many other old and obscure formats.
+
+## Communication
+
+- [Slack](https://slack.com/): Team messaging and collaboration.
+- [WhatsApp](https://www.whatsapp.com/): Desktop client for WhatsApp messaging.
+- [Spotify](https://www.spotify.com/): Music streaming.
 
 ## Office Apps
 
 - [Keynote](http://www.apple.com/mac/keynote/): Create presentations on Mac, this is supposed to be an alternate to PowerPoint.
-- [Microsoft Office](http://www.microsoft.com/mac/buy): Microsoft Office for Mac. Includes Microsoft Word, Excel, PowerPoint and Outlook.
+- [Microsoft Office](https://www.microsoft.com/en-us/microsoft-365/mac/microsoft-365-for-mac): Microsoft Office for Mac. Includes Microsoft Word, Excel, PowerPoint and Outlook.
 - [Numbers](http://www.apple.com/mac/numbers/): Create spreadsheets on Mac, this is supposed to be an alternate to Excel.
 - [Pages](http://www.apple.com/mac/pages/): Create text files on Mac, this is supposed to be an alternate to Word.
 
@@ -69,4 +79,3 @@ Both of these tools can't compare in terms of features and user interface with t
 - [SuperDuper](http://www.shirt-pocket.com/SuperDuper/SuperDuperDescription.html): Take backups of your disk and use the backup disk to restore the machine in case of failure.
 - [TimeOut](http://www.dejal.com/timeout/): Scheduled work breaks to prevent stress injuries.
 - [VLC](http://www.videolan.org/vlc/index.html): VLC Media Player. Enough said.
-- [Voila](http://www.globaldelight.com/voila/): Record your screen with audio, mouse highlight and other features.

docs/bash-completion.md

@@ -7,24 +7,36 @@ Bash completion is a bash function that allows you to auto complete commands or
 arguments by typing partially commands or arguments, then pressing the [Tab]
 key. This will help you when writing the bash command in terminal.
 
-## Installation
+## Install Latest Bash
+
+macOS ships with an outdated version of Bash (3.2). You can install the latest
+version using Homebrew:
 
 ```sh
-brew install bash-completion
+brew install bash
 ```
 
-Bash completion will be installed in `/usr/local/etc/bash_completion.d`.
+To use the Homebrew-installed Bash as your default shell, add it to the list of
+allowed shells and set it:
 
-For it to work, add this to your `~/.bash_profile`:
+```sh
+sudo sh -c 'echo "$(brew --prefix)/bin/bash" >> /etc/shells'
+chsh -s "$(brew --prefix)/bin/bash"
+```
+
+## Installation
+
+Use `bash-completion@2`, which is designed for Bash 4.2+ (the version installed
+by Homebrew):
 
 ```sh
-[ -f /usr/local/etc/bash_completion ] && . /usr/local/etc/bash_completion
+brew install bash-completion@2
 ```
 
-Or simply type:
+For it to work, add this to your `~/.bash_profile`:
 
 ```sh
-echo "[ -f /usr/local/etc/bash_completion ] && . /usr/local/etc/bash_completion" >> ~/.bash_profile
+[[ -r "$(brew --prefix)/etc/profile.d/bash_completion.sh" ]] && . "$(brew --prefix)/etc/profile.d/bash_completion.sh"
 ```
 
 Restart your bash session:
@@ -49,7 +61,7 @@ bisect         cherry         commit         fetch          grep           log
 
 ## More
 
-You can list additional completion packages are available by typing:
+You can list additional completion packages available by typing:
 
 ```sh
 brew search completion
@@ -60,6 +72,3 @@ And you can install them using `brew install` commands, for example:
 ```sh
 brew install docker-completion
 ```
-
-*You can also manually add a bash completion file into
-`/usr/local/etc/bash_completion.d`*

docs/cpp.md

@@ -3,19 +3,19 @@ title: C++
 ---
 
 
-Make sure you have installed [Xcode Command Line Tools](/xcode). Check the C++ version to make sure it is Clang 4.0+.
+Make sure you have installed [Xcode Command Line Tools](/xcode). Verify the compiler is available:
 
 ```console
 $ c++ --version
-Apple LLVM version 5.1 (clang-503.0.38) (based on LLVM 3.4svn)
-Target: x86_64-apple-darwin13.1.0
+Apple clang version 16.0.0 (clang-1600.0.26.6)
+Target: arm64-apple-darwin24.3.0
 Thread model: posix
 ```
 
-To be able to compile files from your terminal you can add the following alias in your `env.sh` file.
+To be able to compile files from your terminal you can add the following alias in your shell configuration file (e.g. `~/.zshrc`).
 
 ```sh
-alias cppcompile='c++ -std=c++11 -stdlib=libc++'
+alias cppcompile='c++ -std=c++17 -stdlib=libc++'
 ```
 
-Then you can run all cpp file directly using `cppcompile main.cpp` and it will use C++11 so no errors in the case of using vectors, auto, sets etc.
+Then you can run all cpp file directly using `cppcompile main.cpp` and it will use C++17.

docs/docker/index.md

@@ -5,77 +5,29 @@ title: Docker
 
 [Docker](https://docs.docker.com) is a platform for developers and sysadmins to develop, ship, and run applications. Docker lets you quickly assemble applications from components and eliminates the friction that can come when shipping code. Docker lets you get your code tested and deployed into production as fast as possible.
 
-With Docker, developers can build any app in any language using any toolchain. “Dockerized” apps are completely portable and can run anywhere - colleagues’ macOS and Windows laptops, QA servers running Ubuntu in the cloud, and production data center VMs running Red Hat.
+With Docker, developers can build any app in any language using any toolchain. "Dockerized" apps are completely portable and can run anywhere - colleagues' macOS and Windows laptops, QA servers running Ubuntu in the cloud, and production data center VMs running Red Hat.
 
-## Docker for Mac
+## Installation
 
-Docker for Mac is the current release of Docker for macOS.
+The recommended way to use Docker on macOS is via **Docker Desktop**.
 
-### Installation
-
-[Download Docker for Mac here](https://docs.docker.com/docker-for-mac/install/).
-
-### Prerequisite
-
-You'll need `homebrew-cask` to install Docker Toolbox, if you don't have it refer to [this section](/homebrew/cask).
-
-### Installation
-
-There are two ways to install Docker
-
-Option 1: These are the steps to install docker using brew
-
-* Install the docker and docker machine from brew
-
-```sh
-brew install docker docker-machine
-```
-
-* Install VirtualBox to let Docker create the images.
-
-```sh
-brew install --cask virtualbox
-```
-
->If you encounter an issue with the installer with an error message like
+### Using Homebrew
 
 ```sh
-The install failed (The installer encountered an error that caused the installation to fail.
-Contact the software manufacturer for assistance.)
+brew install --cask docker
 ```
 
->Use the following When you do fail, turn on System Preference and see if ‘System software from developer “Oracle America, inc” was blocked from loading.’ If you see that message, click Allow button and try to install again.
+### Manual Download
 
-This should complete the installation
+Alternatively, download Docker Desktop from the [official website](https://www.docker.com/products/docker-desktop/).
 
----
-
-Now to create a Machine, follow the following steps:
-
-```sh
-docker-machine create --driver virtualbox default
-```
+### Verify Installation
 
-Run the following to tell Docker which machine to execute Docker on
-
-```sh
-docker-machine env default
-```
-
-Finally, to verify all the installations:
+After installing and launching Docker Desktop, verify the installation:
 
 ```sh
+docker --version
 docker run hello-world
 ```
 
 You can find more about Docker in the [documentation](https://docs.docker.com/).
-
-Option 2: Install using the Docker App
-
-* Navigate to the following link
-
-```sh
-https://hub.docker.com/editions/community/docker-ce-desktop-mac/
-```
-
-This installation should provide you all the necessary GUI tools

docs/emacs.md

@@ -5,7 +5,7 @@ title: Emacs
 
 [Emacs](https://www.gnu.org/software/emacs/) is a family of text editors that are characterized by their extensibility. The manual for the most widely used variant, GNU Emacs, describes it as the extensible, customizable, self-documenting, real-time display editor.
 
-Development of the first Emacs began in the mid-1970s, and work on its direct descendant, GNU Emacs, continues actively as of 2017.
+Development of the first Emacs began in the mid-1970s, and work on its direct descendant, GNU Emacs, continues actively.
 
 ## Installation
 
@@ -59,25 +59,13 @@ Start off by tapping the official emacs-plus cask.
 brew tap d12frosted/emacs-plus
 ```
 
-Emacs Plus contains separate formulas for different Emacs versions:
-
-* emacs-plus - installs Emacs 26, current release version.
+Install the latest version of Emacs Plus:
 
 ```sh
 brew install emacs-plus [options]
 ```
 
-* emacs-plus@27 - installs Emacs 27, next release version.
-
-```sh
-brew install emacs-plus@27 [options]
-```
-
-* emacs-plus@28 - installs Emacs 28, development version.
-
-```sh
-brew install emacs-plus@28 [options]
-```
+You can also install specific versions (e.g. `emacs-plus@29`, `emacs-plus@30`).
 
 <details>
 <summary>Click here to see available options: </summary>
@@ -170,17 +158,13 @@ Upon starting up Emacs for the first time, further third-party packages will be
 
 ## Doom Emacs
 
-[Doom](https://github.com/hlissner/doom-emacs) is a configuration for GNU Emacs written by a stubborn, shell-dwelling, and melodramatic ex-vimmer. It wasn't originally intended for public use, but can be considered a hacker's starter kit.
+[Doom Emacs](https://github.com/doomemacs/doomemacs) is a configuration framework for GNU Emacs. It can be considered a hacker's starter kit.
 
 ### Installation
 
 ```sh
-git clone https://github.com/hlissner/doom-emacs ~/.emacs.d
-cd ~/.emacs.d
-cp init.example.el init.el  # maybe edit init.el
-make install
+git clone --depth 1 https://github.com/doomemacs/doomemacs ~/.config/emacs
+~/.config/emacs/bin/doom install
 ```
 
-Don't forget to run `make` every time you modify `init.el`!
-
-Visit the wiki for [a more detailed guide on installing, customizing and grokking Doom](https://github.com/hlissner/doom-emacs/wiki).
+Visit the [documentation](https://github.com/doomemacs/doomemacs/blob/master/docs/getting_started.org) for a more detailed guide on installing and customizing Doom.