Hub: belgeler, İngilizce README ve issue şablonları

2026-09-25 13:32:16 +00:00 · 2026-09-24 21:04:51 +00:00 · 2026-09-24 21:04:51 +00:00 · 781999c7ef
commit 781999c7ef
parent 21a4fb5a2f
9 changed files with 338 additions and 0 deletions
--- a/.github/ISSUE_TEMPLATE/config.yml
+++ b/.github/ISSUE_TEMPLATE/config.yml
@ -0,0 +1,11 @@
+blank_issues_enabled: true
+contact_links:
+  - name: 📦 Numex Hub'ı aç
+    url: https://hub.numexai.com.tr
+    about: Tek Numex hesabıyla giriş yap.
+  - name: 🏗️ Numex Forge (Git sunucusu)
+    url: https://github.com/numexai/numex-forge
+    about: Depoların durduğu Git sunucusu.
+  - name: 🔒 Güvenlik bildirimi
+    url: mailto:destek@numexai.com.tr
+    about: Güvenlik açıklarını e-postayla bildir.
--- a/.github/ISSUE_TEMPLATE/hata-bildir.yml
+++ b/.github/ISSUE_TEMPLATE/hata-bildir.yml
@ -0,0 +1,55 @@
+name: 🐞 Hata bildir
+description: Numex Hub'da bir hata bildir
+labels: ["hata"]
+body:
+  - type: dropdown
+    id: alan
+    attributes:
+      label: Hub'ın hangi bölümü?
+      options:
+        - Depo yönetimi (oluşturma, dosya düzenleme, commit geçmişi)
+        - AI destekli düzenleme (beta)
+        - Depo bağlamlı sohbet (beta)
+        - Anlık uygulama / geri alma (beta)
+        - Topluluk Vitrini (trend, çatalla, arama)
+        - Canlı Akış
+        - Giriş / hesap (Google, GitHub)
+        - Bilmiyorum
+    validations:
+      required: true
+  - type: input
+    id: tarayici
+    attributes:
+      label: Tarayıcı ve işletim sistemi
+      placeholder: "ör. Chrome 128 · Windows 11"
+    validations:
+      required: true
+  - type: textarea
+    id: ne-oldu
+    attributes:
+      label: Ne oldu?
+      description: Ne bekliyordun, ne oldu?
+    validations:
+      required: true
+  - type: textarea
+    id: adimlar
+    attributes:
+      label: Nasıl tekrarlanır?
+      placeholder: |
+        1. Depoyu açtım
+        2. Sohbete "README'yi güncelle" yazdım
+        3. Uygula'ya bastım
+        4. ...
+  - type: input
+    id: sha
+    attributes:
+      label: İlgili commit SHA'sı (varsa)
+      description: AI değişikliği uyguladıysa Hub commit SHA'sını gösterir.
+  - type: textarea
+    id: ekran
+    attributes:
+      label: Ekran görüntüsü / hata mesajı
+      description: "Token, e-posta, şifre gibi bilgileri gizle. Özel depo içeriği paylaşma."
+  - type: markdown
+    attributes:
+      value: "🔒 Güvenlik açığı mı? Lütfen issue açma: destek@numexai.com.tr"
--- a/.github/ISSUE_TEMPLATE/ozellik-istegi.yml
+++ b/.github/ISSUE_TEMPLATE/ozellik-istegi.yml
@ -0,0 +1,21 @@
+name: 💡 Özellik isteği
+description: Numex Hub için bir fikir öner
+labels: ["öneri"]
+body:
+  - type: textarea
+    id: sorun
+    attributes:
+      label: Hangi sorunu çözüyor?
+    validations:
+      required: true
+  - type: textarea
+    id: oneri
+    attributes:
+      label: Önerin
+    validations:
+      required: true
+  - type: textarea
+    id: ornek
+    attributes:
+      label: Örnek kullanım
+      placeholder: "ör. Sohbete \"şu dosyayı ikiye böl\" yazınca ..."
--- a/README.en.md
+++ b/README.en.md
@ -0,0 +1,82 @@
+<div align="center">
+
+<img src="gorseller/banner.png" alt="Numex Hub — The AI that knows your repo" width="100%">
+
+# 📦 Numex Hub
+
+### Repository management and AI-assisted development — with a single Numex account.
+
+[![Web](https://img.shields.io/badge/hub.numexai.com.tr-00C9A7?style=for-the-badge)](https://hub.numexai.com.tr)
+[![Community](https://img.shields.io/badge/Community_Showcase-NEW-0A1628?style=for-the-badge)](https://hub.numexai.com.tr/topluluk)
+[![Forge](https://img.shields.io/badge/Git-Numex_Forge-0A1628?style=for-the-badge)](https://github.com/numexai/numex-forge)
+
+[🇹🇷 Türkçe](README.md) · 🇬🇧 **English**
+
+</div>
+
+---
+
+> Create and manage Git repositories, and edit them with AI. Sign in to Numex and Hub and Forge are ready for you.
+> **No separate sign-up, no separate password: one Numex account for the whole ecosystem.**
+
+> ℹ️ Hub's interface is in Turkish. The screenshots below show the Turkish UI.
+
+![Numex Hub](gorseller/hub-sayfa.png)
+
+## What does Hub do?
+
+| Feature | Description |
+|---|---|
+| 📦 **Git repository management** | Create repos, edit files, browse commit history. Repos live on [Numex Forge](https://github.com/numexai/numex-forge): real Git. |
+| 🤖 **AI-assisted editing** *(beta)* | Type *"update the README"* in the chat; the AI proposes a code block, you approve, it is committed to Forge. |
+| 💬 **Repo-aware chat** *(beta)* | The AI knows your repo's files: *"add a function to index.js"* → it reads the file and proposes the change. |
+| ⚡ **Instant apply** *(beta)* | Review the proposal, press **Apply** → instant commit. See its SHA and revert if needed. |
+| 🔐 **One account** | Sign in with Google or GitHub; Hub and Forge are enabled automatically. |
+
+## 🌍 Community Showcase *(NEW)*
+
+- ⭐ **Trending repositories**: featured projects with language tags, star and fork counts
+- 🍴 **Fork**: copy a repo you like to your account in one click and build on it
+- 🔍 **Search** repositories
+- 📡 **Live Feed (Live Numex Network)**: push, fork, star and PR activity in real time
+
+## How it works: 4 steps, nothing to install
+
+1. **Sign in to Numex** at [numexai.com.tr](https://numexai.com.tr) with Google or GitHub.
+2. **Open Hub** at [hub.numexai.com.tr](https://hub.numexai.com.tr); you arrive signed in.
+3. **Tell the AI what to change**: *"update the README"*, *"add a new function"*.
+4. **Apply → commit to Forge**: it shows up in history and can be reverted any time.
+
+## Working locally
+
+Every Hub repository is a real Git repository on Forge:
+
+```bash
+git clone https://forge.numexai.com.tr/<user>/<repo>.git
+```
+
+## 📚 Documentation (Turkish)
+
+[Getting started](docs/baslangic.md) · [Community Showcase](docs/topluluk.md) · [Hub and Forge](docs/hub-ve-forge.md) · [FAQ](docs/sss.md)
+
+🐞 Found a bug or have an idea? → [Open an issue](https://github.com/numexai/numex-hub/issues/new/choose)
+
+## Where it fits
+
+```mermaid
+flowchart LR
+    CODEX[🧩 Codex] -->|project| FORGE[(🏗️ Forge · real Git)]
+    HUB[📦 Hub · AI repo interface] <--> FORGE
+    MARKET[🛍️ Market · 44 open-source apps] -->|source code| FORGE
+    HUB -->|Community · fork| USER([👤 You])
+```
+
+---
+
+<div align="center">
+
+**Numex Family** · [Numex AI](https://numexai.com.tr) · [Codex](https://github.com/numexai/numex-codex) · [Okul](https://github.com/numexai/numex-okul) · [Market](https://market.numexai.com.tr) · [Numexpedia](https://github.com/numexai/numex-pedia) · [Hub](https://github.com/numexai/numex-hub) · [Forge](https://github.com/numexai/numex-forge) · [API](https://github.com/numexai/numex-api) · [SDK](https://github.com/numexai/numex-sdk) · [Pusulam](https://github.com/numexai/pusulamx) · [PC Doktoru](https://github.com/mobilcep/pcdoktoru)
+
+*The Turkish AI that puts people first* 🇹🇷 · [Whole ecosystem →](https://github.com/numexai/numex_nedir)
+
+</div>
--- a/README.md
+++ b/README.md
@ -10,6 +10,8 @@
 [![Topluluk](https://img.shields.io/badge/Topluluk_Vitrini-YENİ-0A1628?style=for-the-badge)](https://hub.numexai.com.tr/topluluk)
 [![Forge](https://img.shields.io/badge/Git-Numex_Forge-0A1628?style=for-the-badge)](https://github.com/numexai/numex-forge)

+🇹🇷 **Türkçe** · [🇬🇧 English](README.en.md)
+
 </div>

 ---
@ -52,6 +54,17 @@
 3. **AI'a değişikliği söyle** — *"README'yi güncelle"*, *"yeni fonksiyon ekle"*.
 4. **Uygula → Forge'a commit** — geçmişte görünür, istediğinde geri alınır.

+## 📚 Belgeler
+
+| | |
+|---|---|
+| 🚀 [Hub'a başlarken](docs/baslangic.md) | Giriş, depo oluşturma, AI ile düzenleme, Uygula → commit |
+| 🌍 [Topluluk Vitrini](docs/topluluk.md) | Trend depolar, çatallama, arama, Canlı Akış |
+| 🏗️ [Hub ve Forge](docs/hub-ve-forge.md) | Depolar nerede durur, bilgisayarına nasıl klonlanır |
+| ❓ [SSS](docs/sss.md) | Sık sorulan sorular |
+
+🐞 Hata mı buldun, fikrin mi var? → [Issue aç](https://github.com/numexai/numex-hub/issues/new/choose)
+
 ## Ekosistemdeki yeri

 ```mermaid
--- a/docs/baslangic.md
+++ b/docs/baslangic.md
@ -0,0 +1,48 @@
+# 🚀 Hub'a başlarken
+
+Numex Hub, [Numex Forge](https://github.com/numexai/numex-forge) üzerindeki Git depolarını
+yönetmen ve yapay zekâ ile düzenlemen için bir arayüzdür. Kurulum yok, ayrı kayıt yok.
+
+## 1. Giriş yap
+
+[numexai.com.tr](https://numexai.com.tr)'de **Google** veya **GitHub** ile giriş yap. Numex hesabın
+açıldığında Hub ve Forge hesapların da otomatik hazırdır.
+
+## 2. Hub'ı aç
+
+[hub.numexai.com.tr](https://hub.numexai.com.tr) adresine git; giriş yapmış halde gelirsin.
+
+## 3. Bir depo oluştur ya da aç
+
+- **Yeni depo:** Hub'da depo oluştur. Depo Forge'da gerçek bir Git deposu olarak açılır.
+- **Hazır proje:** [Topluluk Vitrini](topluluk.md)'nden bir depoyu **çatalla**; kendi hesabına
+  kopyalanır.
+
+Depoda dosyaları düzenleyebilir, commit geçmişini görebilirsin.
+
+## 4. AI ile değiştir *(beta)*
+
+Depo açıkken sohbete ne istediğini yaz:
+
+```text
+README'yi güncelle, kurulum adımlarını ekle
+index.js'ye tarih biçimlendiren bir fonksiyon ekle
+```
+
+AI deponun dosyalarını bilir: ilgili dosyayı okur ve değişikliği **kod bloğu olarak önerir**.
+Hiçbir şey sen onaylamadan değişmez.
+
+## 5. Uygula → commit
+
+Öneriyi incele, **Uygula** de. Değişiklik anında Forge'a commit'lenir ve commit'in **SHA**'sı
+görünür. Commit geçmişte kalır; istediğinde geri alabilirsin.
+
+## İpuçları
+
+- İsteğini net yaz: dosya adı ve beklenen sonuç, AI'ın doğru yeri bulmasını kolaylaştırır.
+- Büyük değişiklikleri küçük adımlara böl; her adım ayrı commit olur, geri almak kolaylaşır.
+- Depoyu bilgisayarında da çalışmak istersen Forge'dan klonla → [Hub ve Forge](hub-ve-forge.md).
+
+---
+
+[← README](../README.md) · [Topluluk Vitrini →](topluluk.md)
--- a/docs/hub-ve-forge.md
+++ b/docs/hub-ve-forge.md
@ -0,0 +1,43 @@
+# 🏗️ Hub ve Forge
+
+Hub bir **arayüz**, Forge ise **Git sunucusudur**. Hub'da gördüğün her depo aslında Forge'da duran
+gerçek bir Git deposudur.
+
+| 🏗️ **Forge** | 📦 **Hub** |
+|---|---|
+| Git sunucusu (Gitea tabanlı, Türkçe) — depoların **evi** | Forge üzerinde çalışan **AI destekli arayüz** |
+| Konular (issues), değişiklik istekleri (PR), kilometre taşları | "README'yi güncelle" de → öneri → Uygula → commit |
+| `git clone`, `git push`, dallar, etiketler | Depo bağlamlı sohbet, anlık uygulama, Topluluk Vitrini |
+
+```mermaid
+flowchart LR
+    CODEX[🧩 Codex] -->|proje| FORGE[(🏗️ Forge · gerçek Git)]
+    HUB[📦 Hub · AI depo arayüzü] <--> FORGE
+    MARKET[🛍️ Market] -->|kaynak kodu| FORGE
+    PC([💻 Bilgisayarın]) <-->|git clone / push| FORGE
+```
+
+## Depoyu bilgisayarına al
+
+Hub'da çalıştığın depo Forge'da `<kullanıcı>/<depo>` adıyla durur:
+
+```bash
+git clone https://forge.numexai.com.tr/<kullanıcı>/<depo>.git
+cd <depo>
+# ... düzenle ...
+git add -A && git commit -m "değişiklik"
+git push
+```
+
+Bilgisayarından gönderdiğin commit'ler Hub'da da görünür; Hub'da AI ile yaptığın commit'ler de
+`git pull` ile bilgisayarına gelir. Terminal, VS Code veya Codex IDE, normal bir Git sunucusu gibi çalışır.
+
+## Hangisini ne zaman kullanmalı?
+
+- **Hızlı değişiklik, AI yardımı** → Hub
+- **Konular, PR incelemesi, kilometre taşları, ekip/organizasyon** → Forge
+- **Büyük geliştirme, kendi editörün** → Forge'dan klonla, bilgisayarında çalış
+
+---
+
+[← Topluluk Vitrini](topluluk.md) · [SSS →](sss.md)
--- a/docs/sss.md
+++ b/docs/sss.md
@ -0,0 +1,32 @@
+# ❓ Sık sorulan sorular
+
+**Hub için ayrı kayıt gerekiyor mu?**
+Hayır. [numexai.com.tr](https://numexai.com.tr)'de Google veya GitHub ile giriş yapman yeterli;
+Hub ve Forge otomatik açılır.
+
+**Depolarım nerede duruyor?**
+[Numex Forge](https://github.com/numexai/numex-forge)'da, gerçek Git depoları olarak. Hub bu depoların
+üzerinde çalışan arayüzdür → [Hub ve Forge](hub-ve-forge.md).
+
+**AI benim onayım olmadan dosya değiştirir mi?**
+Hayır. AI değişikliği önerir; **Uygula** demeden commit olmaz.
+
+**AI'ın yaptığı değişikliği geri alabilir miyim?**
+Evet. Her uygulama ayrı bir commit'tir, SHA'sı görünür ve geçmişte kalır; istediğinde geri alırsın.
+
+**Depomu bilgisayarıma indirebilir miyim?**
+Evet: `git clone https://forge.numexai.com.tr/<kullanıcı>/<depo>.git`
+
+**"Beta" ne demek?**
+AI destekli düzenleme, depo bağlamlı sohbet ve anlık uygulama hâlâ geliştiriliyor. Bir hata görürsen
+[bildir](https://github.com/numexai/numex-hub/issues/new/choose).
+
+**Başkasının projesini kullanabilir miyim?**
+[Topluluk Vitrini](topluluk.md)'nden çatallayabilirsin; projenin lisansına uy.
+
+**Güvenlik açığı buldum.**
+Lütfen herkese açık issue açma; destek@numexai.com.tr adresine yaz.
+
+---
+
+[← Hub ve Forge](hub-ve-forge.md) · [README](../README.md)
--- a/docs/topluluk.md
+++ b/docs/topluluk.md
@ -0,0 +1,33 @@
+# 🌍 Topluluk Vitrini
+
+> *"Binlerce geliştiricinin inşa ettiği otonom projeleri keşfedin. Kendi vizyonunuzla birleştirin ve
+> sınırları kaldırın."*
+
+Vitrin, Hub'daki herkese açık projeleri keşfettiğin yerdir:
+[hub.numexai.com.tr/topluluk](https://hub.numexai.com.tr/topluluk).
+
+## Neler var?
+
+| | |
+|---|---|
+| ⭐ **Trend Depolar** | Öne çıkan projeler; dil etiketi, yıldız ve çatal sayılarıyla |
+| 🔍 **Arama** | Depolarda ara |
+| 🍴 **Çatalla** | Beğendiğin depoyu tek tıkla kendi hesabına al, üzerine geliştir |
+| 📡 **Canlı Akış** | Canlı Numex Ağı: push, fork, star ve PR etkinlikleri anında |
+
+## Çatalladıktan sonra
+
+Çatalladığın depo artık senindir: Hub'da açıp AI ile değiştirebilir
+([Hub'a başlarken](baslangic.md)), Forge'dan klonlayıp kendi bilgisayarında çalışabilirsin.
+
+Açık kaynak bir projeyi çatallarken projenin lisansına uy.
+
+## Nereden geliyor bu projeler?
+
+Vitrindeki projelerin bir kısmı Numex'in otonom ürettiği uygulamalardır; kaynak kodları
+[Numex Forge](https://github.com/numexai/numex-forge)'da herkese açıktır. Market'teki
+[açık kaynak uygulamalar](https://market.numexai.com.tr) da kodlarını Forge'da tutar.
+
+---
+
+[← Hub'a başlarken](baslangic.md) · [Hub ve Forge →](hub-ve-forge.md)