Skeletonic Stylus هو مشروع مفتوح المصدر؛ نرحب بالمساهمات من جميع الأحجام — من إصلاحات الأخطاء المطبعية إلى المكوّنات الجديدة.
بداية سريعة
# 1. انسخ واستنسخ
git clone git@github.com:YOUR-USER/skeletonic-stylus.git
cd skeletonic-stylus
# 2. التثبيت (pnpm via corepack)
corepack enable
pnpm install
# 3. البناء
pnpm run build # خط الأنابيب الكامل (stylus → prettier → stylelint → autoprefixer → csso)
# 4. الفحص والاختبار
pnpm run lint
node scripts/a11y-test.mjs
الاتفاقيات
- أسماء الفروع:
feat/short-thing،fix/short-thing،docs/short-thing. - الالتزامات: التزامات تقليدية. جميع الالتزامات موقّعة.
- Stylus: مسافة بادئة من 4 مسافات، بدون فواصل منقوطة، يُفضّل استخدام
$variablesبدلًا من الأرقام السحرية، كل فئة عامة تعيش في طبقة تسلسل. - إمكانية الوصول: أي مكوّن جديد يجب أن يلبي بشكل واضح WCAG 2.2 AA؛
شغّل
node scripts/a11y-test.mjsعلى صفحة العرض قبل فتح طلب سحب. - ميزانية الحجم: يجب أن تبقى ورقة الأنماط الأساسية تحت 8 كيلوبايت مضغوط. إذا تجاوز تغييرك هذا الحد، برّره في طلب السحب.
طلبات السحب
- افتح مشكلة أولًا لأي تغيير غير بسيط — يوفّر إعادة العمل.
- اجعل طلبات السحب مركّزة: تغيير منطقي واحد لكل طلب سحب.
- حدّث
CHANGELOG.mdتحت "غير مُصدر". - تأكد أن CI أخضر قبل طلب المراجعة.
- الدمج بالضغط هو الافتراضي؛ سيتم تنظيف رسائل الالتزام عند الدمج.
مدونة السلوك
بمشاركتك، توافق على الالتزام بـ ميثاق المساهم 2.1. كن لطيفًا، كن صبورًا، افترض حسن النية.