From c16dd28fa3b8b8cbff06553c20dd7222933aacf2 Mon Sep 17 00:00:00 2001 From: Numex AI <82294946+mobilcep@users.noreply.github.com> Date: Fri, 25 Sep 2026 01:31:00 +0300 Subject: [PATCH] =?UTF-8?q?Hub:=20belgeler,=20=C4=B0ngilizce=20README=20ve?= =?UTF-8?q?=20issue=20=C5=9Fablonlar=C4=B1=20(#2)?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit - docs/: Hub'a başlarken, Topluluk Vitrini, Hub ve Forge, SSS - README.en.md eklendi; README'ye dil bağlantısı ve belge tablosu eklendi - .github/ISSUE_TEMPLATE: hata bildir, özellik isteği, iletişim bağlantıları --- .github/ISSUE_TEMPLATE/config.yml | 11 +++ .github/ISSUE_TEMPLATE/hata-bildir.yml | 55 +++++++++++++++ .github/ISSUE_TEMPLATE/ozellik-istegi.yml | 21 ++++++ README.en.md | 82 +++++++++++++++++++++++ README.md | 13 ++++ docs/baslangic.md | 48 +++++++++++++ docs/hub-ve-forge.md | 43 ++++++++++++ docs/sss.md | 32 +++++++++ docs/topluluk.md | 33 +++++++++ 9 files changed, 338 insertions(+) create mode 100644 .github/ISSUE_TEMPLATE/config.yml create mode 100644 .github/ISSUE_TEMPLATE/hata-bildir.yml create mode 100644 .github/ISSUE_TEMPLATE/ozellik-istegi.yml create mode 100644 README.en.md create mode 100644 docs/baslangic.md create mode 100644 docs/hub-ve-forge.md create mode 100644 docs/sss.md create mode 100644 docs/topluluk.md diff --git a/.github/ISSUE_TEMPLATE/config.yml b/.github/ISSUE_TEMPLATE/config.yml new file mode 100644 index 0000000..9d3258d --- /dev/null +++ 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. diff --git a/.github/ISSUE_TEMPLATE/hata-bildir.yml b/.github/ISSUE_TEMPLATE/hata-bildir.yml new file mode 100644 index 0000000..daa3f8d --- /dev/null +++ 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" diff --git a/.github/ISSUE_TEMPLATE/ozellik-istegi.yml b/.github/ISSUE_TEMPLATE/ozellik-istegi.yml new file mode 100644 index 0000000..4e56cde --- /dev/null +++ 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 ..." diff --git a/README.en.md b/README.en.md new file mode 100644 index 0000000..d5699bf --- /dev/null +++ b/README.en.md @@ -0,0 +1,82 @@ +
+ +Numex Hub — The AI that knows your repo + +# 📦 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** + +
+ +--- + +> 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//.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]) +``` + +--- + +
+ +**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) + +
diff --git a/README.md b/README.md index 3f665ec..36e8426 100644 --- 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) + --- @@ -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 diff --git a/docs/baslangic.md b/docs/baslangic.md new file mode 100644 index 0000000..d0192fb --- /dev/null +++ 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) diff --git a/docs/hub-ve-forge.md b/docs/hub-ve-forge.md new file mode 100644 index 0000000..c24519d --- /dev/null +++ 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 `/` adıyla durur: + +```bash +git clone https://forge.numexai.com.tr//.git +cd +# ... 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) diff --git a/docs/sss.md b/docs/sss.md new file mode 100644 index 0000000..21fe762 --- /dev/null +++ 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//.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) diff --git a/docs/topluluk.md b/docs/topluluk.md new file mode 100644 index 0000000..ceca682 --- /dev/null +++ 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)