dev jot

Dev-Jot (الإصدار الافتراضي)-https://dev-jot.netlify.app

Dev-Jot هو تطبيق تدوين الملاحظات للدروس التعليمية للمطور عبر الإنترنت. المشروع هو MVP وقد تم إنشاؤه لمساعدة المطورين الأماميين الطموحين كجزء من نظام دعم thefrontendcoach.

هناك نسختان من التطبيق:

1. الافتراضي ، إصدار الفانيليا: https://dev-jot.netlify.app
2. رد الفعل: https://dev-jot-react.netlify.app

يرجى الانضمام إلى Discord Community Discord.gg/ymsd9sgz4f

غرض المشروع

بالنسبة لأولئك الذين يقومون بالتعليم الذاتي ، من السهل حقًا أن تجد نفسك عالقًا في "الأراضي التعليمية" أو "هيل التعليمي". بالنسبة للعديد من المبرمجين الجدد ، من الصعب سد الفجوة بين ما تتعلمه من البرامج التعليمية واكتساب المهارات التي تحتاجها لتصبح مطورًا قابلاً للتوظيف.

هدفك النهائي هو تكرار ما ستفعله بالفعل في وظيفة تطوير حقيقية قدر الإمكان. المساهمة في المصدر المفتوح هي طريقة رائعة للقيام بذلك. سيتطلب منك تقديم مساهمات مفتوحة المصدر أن تتعرض لبعض المفاهيم والممارسات المهمة والمهارات القابلة للتحويل:

• السيطرة على الإصدار
• العمل مع التذاكر والقضايا
• العمل مع المطورين الآخرين
• إنشاء طلبات سحب
• تجربة عملية مراجعة الكود
• إنشاء بيئة تنمية محلية
• رمز مساهمة في قاعدة كود موجودة مسبقًا

الفكرة العامة

يعمل هذا المشروع كنقطة دخول ودية في عالم المصدر المفتوح. يمكن أن يكون جعل أول مساهمة مفتوحة المصدر احتمالًا شاقًا يؤدي إلى تأجيل الكثير من المطورين الطموحين.

الهدف الأساسي لهذا المشروع هو إنشاء بيئة ترحيبية وودية لتعزيز التعلم ، والشعور بالأمان في ارتكاب الأخطاء ، وتلقي التعليقات والتوجيه أثناء العمل مع المطورين الآخرين.

سيقود اتجاه المشروع أولئك الذين يساهمون. هناك مجال لإضافة مجموعة كبيرة ومتنوعة من الميزات وأيضًا لإعادة بناء التطبيق بتقنيات مختلفة.

الحالة الحالية

هذا هو تطبيق عدم الالتفاف. يتم تخزين ملاحظات الدرس حاليًا في التخزين المحلي للمتصفح. الغرض من التطبيق هو تمكين أولئك الذين يدرسون على أنفسهم لإنشاء متجر بسيط ونظيف لجميع ملاحظات الدروس والدرس.

هناك نسختان من التطبيق. يقع الإصدار الافتراضي الرئيسي داخل دليل app-main . هذا الإصدار الافتراضي من التطبيق هو HTML و CSS و Vanilla JavaScript حتى هناك فرص تعليمية للمساهمين في العمل مع الأساسيات.

تم تصميم الإصدار الثاني باستخدام React ويقع داخل دليل app-react . يوفر هذا فرصة للمساهمين الذين يتطلعون إلى العمل مع إطار عمل أمامي للحصول على أيديهم قذرة.

قبل المساهمة ، أوصي بشدة أن تلعب مع الإصدار المباشر واستخدامه بالفعل لبعض التدوين الأساسي. ما الذي تمتص عن ذلك؟ ماذا يمكن تحسين؟ هل رصدت أي أخطاء؟

سيتم تحديد اتجاه المشروع من قبل أولئك الذين يساهمون. إذا كان لديك بعض الأفكار الرائعة لميزات جديدة كبيرة أو صغيرة ثم رائعة! مجرد إنشاء مشكلة للمناقشة قبل القيام بذلك؟

إعداد المشروع

أسهل وأسرع طريقة للحصول على المشروع الافتراضي وتشغيله محليًا هي استنساخ الريبو:

git clone https://github.com/jrobind/dev-jot.git

تأكد من أنك في دليل app-main

 cd app-main

الآن قم بتثبيت الحزم مع NPM

npm i

نظرًا لأن إصدار المشروع الافتراضي يستخدم وحدات JavaScript ، فقد تواجه أخطاء Cors إذا حاولت الوصول إلى الملفات على نظام الملفات المحلي مع JavaScript. أوصي باستخدام VS Code كـ IDE الخاص بك ، وأوصي أيضًا بتثبيت ملحق خادم VS Code Live .

يتم تقديم المشروع المباشر من /app-main/public لذا ستحتاج إلى توجيه الخادم المباشر هنا أيضًا. للقيام بذلك:

1. قم بالوصول إلى إعدادات ملحق Live في VS Code بالنقر فوق رمز COG وتحديد "إعدادات الامتداد"

2. انقر فوق "تحرير في الإعدادات. json"

3. اضبط الجذر على: "liveServer.settings.root": "/app-main/public"

يمكنك الآن تشغيل المشروع باستخدام امتداد Server Live عن طريق النقر بزر الماوس الأيمن على index.html وتحديد "Open with Live Server".

إذا كنت غير متأكد ، فيرجى إلقاء نظرة على الوثائق.

الرمز

يعيش HTML و CSS و JavaScript حاليًا ضمن /app-main/public Directory. يقع JavaScript الرئيسي داخل index.js .

المساهمة

يرجى مراجعة المساهمة. md لمزيد من المعلومات حول كيفية المساهمة.