# 03 — Adding and editing files

🌍 **English** · [Türkçe](../../tr/03-add-and-edit-files/readme.md) · [Deutsch](../../de/03-add-and-edit-files/readme.md) · [Français](../../fr/03-add-and-edit-files/readme.md) · [Русский](../../ru/03-add-and-edit-files/readme.md)

Everything in this chapter happens in the browser. No tools to install.

## Add File menu

Open a repository (or any folder inside it) and press **Add File**:

| Item | Use it for |
|------|-----------|
| **New File** | Writing a file by hand — notes, code, `readme.md` |
| **New Directory** | Creating an empty folder (chapter 04) |
| **Upload File** | Bringing files from your computer — images, PDFs, archives |
| **Patch** | Applying a ready-made diff |

## Writing a new file

1. **Add File → New File**.
2. Type the file name at the top, for example `notes.md`.
   Typing `docs/notes.md` creates the `docs` folder at the same time.
3. Write the content in the editor.
4. Fill in the commit box at the bottom:
   - **Summary** — short, in the imperative: *add setup notes*.
   - **Description** — optional detail.
5. Choose **Commit directly to `main`**, or *create a new branch* if you want a review first (chapter 09).
6. Press **Commit Changes**.

## Uploading files

1. **Add File → Upload File**.
2. Drag files in, or press the box to pick them.
3. To place them in a subfolder, type the folder name in the path field at the top.
4. Press **Commit Changes**.

Very large files (video, disk images) belong in file storage, not in a repository — the history keeps every version forever.

## Editing an existing file

1. Open the file.
2. Press the pencil ✏️ icon at the top right.
3. Change the text; the **Preview changes** tab shows what you altered.
4. Commit as above.

## Renaming and moving

Editing a file lets you change its path: put the cursor in the name field and type a new path, e.g. `docs/notes.md`. On commit, the file is moved — history is preserved.

---

⬅ [Previous: 02 — Creating a repository](../02-create-repository/readme.md) · 📚 [Contents](../README.md) · [Next: 04 — Creating directories](../04-create-directory/readme.md) ➡