Hagaha
Contributors

Ku soo dhawoow 👋

Waad mahadsantahay xiisahaaga in aad ku biirto Ereyle! Mashruucan wuxuu ku dhisanyahay shaqada dadka badan oo xiisaynaya inay waxbarashada qoraalka ah ka dhigaan mid la heli karo.

Sida Loo Bilaabo

1. Fork & Clone

git clone https://github.com/YOUR-USERNAME/ereyle.com.git
cd ereyle.com
npm install
npm run dev

2. Samee Branch Cusub

Branches-ku waa inay raacaan hab-magacaabistan:

# Arrin cusub
git checkout -b feat/lesson-writing-intro

# Bug-fix
git checkout -b fix/navbar-mobile-scroll

# Dukumiinti
git checkout -b docs/contributing-somali

3. Samee Isbeddel

npm run build   # xaqiiji dhismaha
npm run dev     # eeg si toos ah

4. Commit & Push

Raac Conventional Commits:

git commit -m "feat(lessons): add writing introduction lesson"
git commit -m "fix(navbar): correct mobile menu close on route change"
git commit -m "docs: update contribution guide in Somali"

5. Fur Pull Request

Fur PR GitHub-ka. Ku sharax:

• Maxaa la beddelay iyo sababta
• Screenshots haddii ay jiraan isbeddelka UI-ga
• Issue-ga uu xallinayo: Closes #42

Ku Dar Cashar Cusub

1. Dooro Koorso

Eeg src/content/courses/. Haddii koorsadu aysan jirin, ku dar JSON cusub ama fur Issue si looga wada hadlo.

2. Samee Fayl MDX

# Tusaale: src/content/lessons/writing-basics/1-introduction.mdx
---
title: "Introduction to Clear Writing"
description: "Learn how to turn an idea into a clear paragraph."
order: 1
course: "writing-basics"
---

# Cinwaanka
Qoraalkaaga halkan...

3. Heerka Tayada ✅

• Casharku waa inuu leeyahay ujeeddo cad
• Tusaalooyinka iyo layliyadu waa inay sax yihiin oo fudud yihiin
• Waa inuu taageeraa Af-Soomaali iyo Ingiriis
• Habaynta casharka (order) waa inay sax tahay
• Isticmaal <InteractiveChallenge> marka suurtagalka ah

4. Components-ka MDX

import InteractiveChallenge from '../../../components/InteractiveChallenge';
import VerifiedTutor from '../../../components/VerifiedTutor.astro';

<VerifiedTutor name="Axmed Faarax" role="Course Author" github="axmedfarax" />

<InteractiveChallenge
  title="Practice"
  description="Samee layliga ku jira casharka."
  hint="U kala jab tallaabooyin yaryar."
/>

Ku Dar Maqaal Blog

Maqaalladu waxay ku jiraan src/content/blog/. Qor fayl MDX:

---
title: "Cinwaankaaga"
description: "Sharaxaad kooban."
pubDate: 2025-06-01
author: "ereyle-team"
tags: ["waxbarasho", "qoraal"]
featured: false
---

Nuxurkaaga halkan...

Hagaha Naqshadeynta

Marka aad wax ka beddelayso UI-ga, raac nidaamkan:

Midabada

Fonts

• DM Sans — Body, UI elements
• Instrument Serif — Display headings (italic accent)
• JetBrains Mono — Code blocks

Classes la isticmaalo

<a class="btn-signal">CTA</a>
<a class="btn-ghost">Secondary</a>
<div class="card">White card</div>
<div class="card-dark">Dark card</div>
<span class="badge">Pill label</span>
<div class="sr">Scroll-reveal element</div>

• Mobile-first waa waajib — test on 375px
• Dhammaan interactive elements waa inay leeyihiin focus states
• Ha isticmaalin midabada hardcoded — isticmaal CSS variables

Hannaanka Dib-u-eegista PR

PR-kasta waxaa eegi doona xubin ka mid ah maintainers-ka gudaha 3 maalmood shaqo. Waxaan eegaynaa:

• Tayada qoraalka, tusaalooyinka, iyo koodhka haddii uu jiro
• Ku-dhaqanka hagaha naqshadeynta
• Mobile iyo accessibility
• SEO (meta tags, structured data)
• Adeegsiga saxda ah ee luqadda

Xiriirka

Su'aalo ma qabtaa?

• Email: hello@ereyle.com
• GitHub Discussions: github.com/ereyle/ereyle.com/discussions
• Issues: github.com/ereyle/ereyle.com/issues