guide/03-add-and-edit-files/readme.md

🇬🇧 03 — Adding and editing files

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.

---

🇹🇷 03 — Dosya ekleme ve düzenleme

Bu bölümdeki her şey tarayıcıda yapılır. Kurulacak araç yoktur.

Dosya Ekle menüsü

Bir depoyu (veya içindeki bir klasörü) açıp Dosya Ekle'ye basın:

Öğe	Ne için
Yeni Dosya	Elle dosya yazmak — notlar, kod, readme.md
Yeni Dizin	Boş klasör oluşturmak (bölüm 04)
Dosya Yükle	Bilgisayarınızdan dosya getirmek — görsel, PDF, arşiv
Yama	Hazır bir fark (diff) uygulamak

Yeni dosya yazma

1. Dosya Ekle → Yeni Dosya.
2. Üstteki alana dosya adını yazın, örneğin notlar.md. belgeler/notlar.md yazarsanız belgeler klasörü de aynı anda oluşur.
3. İçeriği editöre yazın.
4. Alttaki işleme kutusunu doldurun:
   • Özet — kısa ve emir kipinde: kurulum notları eklendi.
   • Açıklama — isteğe bağlı ayrıntı.
5. Doğrudan main bölümüne uygula seçin ya da önce inceleme istiyorsanız yeni bir dal oluştur (bölüm 09).
6. Değişiklikleri Uygula'ya basın.

Dosya yükleme

1. Dosya Ekle → Dosya Yükle.
2. Dosyaları sürükleyin ya da kutuya basıp seçin.
3. Alt klasöre koymak için üstteki yol alanına klasör adını yazın.
4. Değişiklikleri Uygula'ya basın.

Çok büyük dosyalar (video, disk imajı) depoya değil dosya depolamaya aittir — geçmiş, her sürümü sonsuza dek saklar.

Var olan dosyayı düzenleme

1. Dosyayı açın.
2. Sağ üstteki kalem ✏️ ikonuna basın.
3. Metni değiştirin; Değişiklikleri önizle sekmesi neyi değiştirdiğinizi gösterir.
4. Yukarıdaki gibi işleyin.

Yeniden adlandırma ve taşıma

Düzenleme ekranında yolu değiştirebilirsiniz: ad alanına yeni yolu yazın, örneğin belgeler/notlar.md. İşlediğinizde dosya taşınır — geçmiş korunur.