Skip to content
Closed
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
1 change: 1 addition & 0 deletions docs.json
Original file line number Diff line number Diff line change
Expand Up @@ -24,6 +24,7 @@
"index",
"quickstart",
"installation",
"git",
{
"group": "Web editor",
"icon": "mouse-pointer-2",
Expand Down
131 changes: 131 additions & 0 deletions git.mdx
Original file line number Diff line number Diff line change
@@ -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

<Tabs>
<Tab title="Windows">
### Option 1: Download from Git website

Check warning on line 16 in git.mdx

View check run for this annotation

Mintlify / Mintlify Validation (mintlify) - vale-spellcheck

git.mdx#L16

': D' should be in lowercase.

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
```
</Tab>

<Tab title="macOS">
### Option 1: Using Homebrew (recommended)

Check warning on line 41 in git.mdx

View check run for this annotation

Mintlify / Mintlify Validation (mintlify) - vale-spellcheck

git.mdx#L41

': U' should be in lowercase.

Check warning on line 41 in git.mdx

View check run for this annotation

Mintlify / Mintlify Validation (mintlify) - vale-spellcheck

git.mdx#L41

Use parentheses judiciously.

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
```
</Tab>

<Tab title="Linux">
### 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
```
</Tab>
</Tabs>

## 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 "[email protected]"
```

These settings will be used for all your Git commits.

Check warning on line 120 in git.mdx

View check run for this annotation

Mintlify / Mintlify Validation (mintlify) - vale-spellcheck

git.mdx#L120

Avoid using 'will'.

Check warning on line 120 in git.mdx

View check run for this annotation

Mintlify / Mintlify Validation (mintlify) - vale-spellcheck

git.mdx#L120

In general, use active voice instead of passive voice ('be used').

## Next steps

Check warning on line 122 in git.mdx

View check run for this annotation

Mintlify / Mintlify Validation (mintlify) - vale-spellcheck

git.mdx#L122

'Next steps' should use sentence-style capitalization.

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.