# Katkıda Bulunma Rehberi

## 🎈 Aramıza Katılma İsteğin Bizi Sevindirdi

* 📚 Tüm dersleri [YEmreAk/IstanbulUniversity-CE](https://github.com/YEmreAk/IstanbulUniversity-CE) adıyla GitHub üzerinde *açık olarak* derlenmektedir
* 🤝 Katkı sağlama işlemleri de GitHub üzerinden yapılmaktadır
* 🏹 Sağ üst köşedeki **Edit on Github** alanından da proje sayfasına yönelebilirsin
* 🌃 [Open in Gitpod](https://gitpod.io/#https://github.com/YEmreAk/IstanbulUniversity-CE) aracılığıyla sanal makinede tüm dosyaları yönetebilirsin

> 📹 IUCE \~ YEmreAk sitesi sadece sunum aracıdır

## 💡 Fikir Belirtme <a href="#fikir-belirtme" id="fikir-belirtme"></a>

* 📙 Ders notu ihtiyacın, tavsiyelerin veya hata tespitlerin varsa [🦋 Issue](https://github.com/yedhrab/IstanbulUniversity-CE/issues) açabilirsin
* 📈 Bu yapı sayesinde aranan dersler daha belirgin olacaktır.
* 👮‍♂️ **Yapıcı** eleştirileriniz veya fikirleriniz ile gelişime ortak olabilirsiniz

> 📌 **ISSUE** kurallarına uygun hareket etmeniz sorunun çözülmesine hız katacaktır.

## 📙 Ders Notları Ekleme <a href="#ders-notlari-ekleme" id="ders-notlari-ekleme"></a>

Açık kaynaklı projeye ders notların ile katkı sağlamak için:

* 💫 Ders notlarınızı [📕 Online2PDF](https://online2pdf.com/) ile PDF'e çeviriniz.
* [👮‍ Adlandırma Kuralı](https://github.com/yemreak/blog/blob/main/docs/tr/arsiv/iuc-ce/CONTRIBUTING.md#adlandirma-kurali)'na göre adlandırın
* [🚙 Dosya Konumlandırması](https://github.com/yemreak/blog/blob/main/docs/tr/arsiv/iuc-ce/CONTRIBUTING.md#dosya-konumlandirmasi)'na göre koyamanız gereken dizini belirleyin
* [🚀 Web Üzerinden Katkıda Bulunma](https://github.com/yemreak/blog/blob/main/docs/tr/arsiv/iuc-ce/CONTRIBUTING.md#web-uzerinden-katkida-bulunma) ile yükleme işlemini gerçekleştirin

> 👨‍💻 Dosyaya link vermene **gerek yoktur**, scriptim ile otomatik halletmekteyim.

### 👮‍ Adlandırma Kuralı <a href="#adlandirma-kurali" id="adlandirma-kurali"></a>

| 👮‍ Kural          | 📑 Format                                                           |
| ------------------ | ------------------------------------------------------------------- |
| 📕 Öğrenci notları | `<tip> <yıl> <ders_kodu> ~ <sahibi>`                                |
| 📃 Sınav           | `<tip> <yıl> <ders_kodu>`                                           |
| 📚 Ders notu       | `<hafta \| konu> <yıl> <ders kodu>` veya orjinal ismi ile kalabilir |

> ❣️ `Vize, Final veya Büt` özellikleri, tarihinden daha önemli olduğundan ilk onlar yazılmalıdır

| 👮‍ Kural | 📜 Açıklama                                                        |
| --------- | ------------------------------------------------------------------ |
| Tip       | `Vize`, `Final`, `Quiz`, tüm notlar için `Tam` vs                  |
| Yıl       | `2019`, `2020`                                                     |
| Ders Kodu | Dersinin adının baş harfleri (`NYP` Nesneye yönelik programlama)   |
| Sahibi    | Hocanın verdiği notsa boş bırakın, aksi halde isminizi lütfedin ✨  |
| Hafta     | Kaçıncı haftanın notu olduğu (`1. Hafta`, `2. Hafta`, `Son Hafta`) |
| Konu      | Derste işlenen konu (`Services`, `Multiprocessing`)                |

### 🚙 Dosya Konumlandırması <a href="#dosya-konumlandirmasi" id="dosya-konumlandirmasi"></a>

| ⭐ Örnek Dosya İsmi                     | 📁 Koyulması gereken yer                                |
| -------------------------------------- | ------------------------------------------------------- |
| `Final 2018 BM ~ YEmreAk.pdf`          | `donem6\bilgisayar-mimarisi\ogrenci-notlari`            |
| `Tam 2018 Calculus ~ Asma Mirkhan.pdf` | `donem1\calculus-1\ogrenci-notlari`                     |
| `Final 2018 BM.pdf`                    | `donem6\bilgisayar-mimarisi\sinav-sorulari`             |
| `Giriş 2020 BPG.pdf`                   | `donem7\bilisim-proje-gelistirme\ders-icerigi\sunumlar` |

## 🚀 Web Üzerinden Katkıda Bulunma <a href="#web-uzerinden-katkida-bulunma" id="web-uzerinden-katkida-bulunma"></a>

[![Open in Gitpod](https://gitpod.io/button/open-in-gitpod.svg)](https://gitpod.io/#https://github.com/YEmreAk/IstanbulUniversity-CE)

* 🌍 GitHub projelerini `clone` edip, internetini harcamak yerine projeye web üzerinden katkıda bulunabilirsin.
* ✨ Güncel bilgiler için [🌍 GitHub Web](https://lib.yemreak.com/proje-yoenetimi/github/github-web) yazıma bakabilirsin
* 🌃 [Open in Gitpod](https://gitpod.io/#https://github.com/YEmreAk/IstanbulUniversity-CE) aracılığıyla sanal makinede işlemlerinizi yapabilirsiniz
* ⚠️ Katkı sağlama işlemi GitHub hesabı gerektirir.

> 💁‍♂️ Videolar faydalı olmadıysa bana WhatsApp veya Mail üzerinden atabilirsin.

## ✍ Çalışma Notları

Markdown hakkında detaylı açıklamalara [📑 Markdown](https://lib.yemreak.com/1-programlama-notlari/0-genel-notlar/2-markdown) bağlantısından erişebilirsin

* Her şey **dinamik** olmalı
* Önemli notlar ve başlıklar **bold**
* Butonlar ve tıklanabilir öğeler button `<kbd>button</kbd>`
* Terimler *italik* `_italik_`
  * Önce normal yaz, sonrasında ✲ Ctrl + H ile metinleri italik hale dönüştür
* Kalıplar ve sabit ifadeler \` arasına yazılmalı
* Kodlar \`\`\` arasına yazılmalı
* Matematikler (latex) $latex$ `$$latex$$ (gitbook) veya $latex$ (github)`

## 📑 İçerik Yazma Formatı

Başlık ile alakalı bir emoji koyman verimlilik adına çok etkilidir.

* Windows üzerinde, ❖ Win Ş ile emoji klavyesini açabilirsin
* Linux için [😎 Emoji Selector](https://extensions.gnome.org/extension/1162/emoji-selector/) eklentisini kullanabilirsin

> 📌 **Formata (**[**markdown**](https://lib.yemreak.com/1-programlama-notlari/0-genel-notlar/2-markdown)**'a) uygun şekilde katkıda bulunursanız hoş olur 😊**

```md
## 🌟 Başlık

Giriş cümlesi veya alakalı cümle.

- Alaklı maddesel bilgiler
- Bilgi 2

> Varsa ek yorum

<!-- Tablo oluşturman gerekiyorsa -->
| Tablo        | Tablo1                      |
| ------------ | --------------------------- |
| `<değişken>` | Tablosal yapı ile örnekleme |

- `<değişken>` Tablo değişkenlerini açıklama
  - Örn: `kod` örneklendirme


<!-- Tek bağlantı varsa -->
> [Kaynak ismi](https://yemreak.com)

<!-- Birden fazla bağlantı varsa -->
> Ek bağlantılar:
>
> - [Link](https://yemreak.com)
> - [Link](https://yemreak.com)
> - [Link](https://yemreak.com)
```

## ⚓ GitHook'lar

* ❣️ Bu alana sadece **ne olduğunu biliyorsan** bakmanı tavsiye ederim.
* 📢 Ders notu ekleme gibi işlemler, yaptıktan sonra bilene haber edebilirsiniz
* 💁‍♂️ Zaten eklenme işlemleri ile oluşan *pull request* bilen tarafından kabul edilecektir

### 💫 GitBook İndekslemesini Yapma

Projeyi güncelleme işlemi için alttaki komutları veya `integrate.sh` scriptini kullanın

* `pip3 install ypackage` ile ypackage paketimi indirin
* `ygitbookintegration .` komutu ile entegrasyonu sağlayın

> Komut hakkında detaylar için `ygitbookintegration -h` yazabilirsiniz.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.yemreak.com/arsiv/iuc-ce/katkida-bulunma-rehberi.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
