diff --git a/docs.json b/docs.json index 2f8762811..4f5d768fa 100644 --- a/docs.json +++ b/docs.json @@ -24,6 +24,7 @@ "index", "quickstart", "installation", + "git", { "group": "Web editor", "icon": "mouse-pointer-2", diff --git a/git.mdx b/git.mdx new file mode 100644 index 000000000..6c9096d8a --- /dev/null +++ b/git.mdx @@ -0,0 +1,131 @@ +--- +title: Git +description: Learn how to install Git on your system to manage version control for your documentation +--- + +Git is a distributed version control system that helps you track changes in your documentation files. You'll need Git installed to work with your documentation repository. + +## Prerequisites + +Before installing Git, ensure you have administrative privileges on your system. + +## Installation by operating system + + + + ### Option 1: Download from Git website + + 1. Visit [git-scm.com](https://git-scm.com/download/win) + 2. Download the latest version for Windows + 3. Run the installer and follow the setup wizard + 4. Accept the default settings unless you have specific requirements + + ### Option 2: Using Chocolatey + + If you have Chocolatey installed, run: + + ```bash + choco install git + ``` + + ### Option 3: Using Winget + + If you have Windows Package Manager: + + ```bash + winget install --id Git.Git -e --source winget + ``` + + + + ### Option 1: Using Homebrew (recommended) + + If you have Homebrew installed: + + ```bash + brew install git + ``` + + ### Option 2: Download from Git website + + 1. Visit [git-scm.com](https://git-scm.com/download/mac) + 2. Download the latest version for macOS + 3. Open the downloaded `.dmg` file and follow the installation instructions + + ### Option 3: Using Xcode Command Line Tools + + Git comes bundled with Xcode Command Line Tools: + + ```bash + xcode-select --install + ``` + + + + ### Ubuntu/Debian + + ```bash + sudo apt update + sudo apt install git + ``` + + ### CentOS/RHEL/Fedora + + For CentOS/RHEL: + ```bash + sudo yum install git + ``` + + For Fedora: + ```bash + sudo dnf install git + ``` + + ### Arch Linux + + ```bash + sudo pacman -S git + ``` + + ### Alpine Linux + + ```bash + sudo apk add git + ``` + + + +## Verify installation + +After installation, verify Git is working correctly: + +```bash +git --version +``` + +You should see output similar to: +``` +git version 2.39.0 +``` + +## Initial configuration + +Configure Git with your name and email address: + +```bash +git config --global user.name "Your Name" +git config --global user.email "your.email@example.com" +``` + +These settings will be used for all your Git commits. + +## Next steps + +Now that you have Git installed, you can: + +- Clone your documentation repository +- Create and manage branches +- Track changes to your documentation files +- Collaborate with your team using version control + +For more information about using Git with your documentation, see the [Web editor](/editor/getting-started) section. \ No newline at end of file