العمل بشكل فعال كفريق هي احدى الجوانب الاكثر صعوبة في تطوير البرامج. تكون هذه المشكلة اكبر بالنسبة للمبرمجين عديمي الخبرة لأن طريقة نظام النص التشفيري للبرنامج ستؤثر على مدى تعامل اعضاء الفريق مع بعضهم البعض. لحسن حظنا، نحن نستخدم “جانقو”، لقد تم تنظيم طريقة عمل نظام الشفرة مسبقاً، مشاريع “جانقو” منظمة لكي نستغل ال “OOP” و نتمكن من العمل كفريق بشكل فعال.

ويبقى السؤال: كيف لأعضاء الفريق أن يتعاملوا مع بعضهم و يجمعوا النص التشفيري الى نص موحد.

هناك طريقتين للتعاون أو للعمل كفريق:

1- التعاون المتزامن

في التعاون المتزامن عبر الانترنت، أعضاء الفريق المتعاون يقومون بالعمل على نفس الملف في نفس الوقت مع بعضهم البعض، تسهل هذه العملية خلال موقع “repl.it” و تتطلب فقط إرسال رابط الملف الى اعضاء الفريق، موقع “repl.it” يقوم بعمل فعال في التعاون المتزامن حيث أنه يسمح لأعضاء المجموعة أن يعملوا على ملف واحد في آن واحد وأن يتواصلوا مع بعضهم خلال العمل.

مع ذلك، هذا النوع من المشاركة محدود: ١. يتطلب جدول منسق ٢. عدد المشاركين محدود، من المنطقي أن يعمل فردان في وقت واحد ٣. مساهمة الأفراد غير متابعة ٤. ممكن أن تتطلب خبرة فرد من الأفراد لتتم عملية المشاركة بنجاح

الفائدة الأساسية للمشاركة المتزامنة عبر الانترنت هي مشاركة العلم. يعمل المساهمين على حل المشاكل و في النهاية يستفيد الفرد الأقل خبرة بشكل كبير من أعضاء الفريق الآخرين، التعاون المتزامن مشابه ل”eXprogramming” نوعا ما.

كيفية استخدام التعاون المتزامن على موقع Replit.com؟

هناك طريقتان رئيسيتان:

1. قم بإنشاء فريق repl كجزء من [فريق MISCBA على replit.com] يسمى repl متعدد اللاعبين (https://replit.com/team/miscba)

ثم شارك عنوان ال url من المتصفح:

2. بدلا من ذلك، يمكنك إنشاء repl عادي مع إضافة متعاونين باستخدام زر المشاركة:

2- Asynchronous Collaboration

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

سيتطلب استخدام git أو github من المطورين تعلم أداة جديدة قد لا يكون من السهل تعلمها في البداية. ولكن بمجرد استخدام المطورين للأداة بشكل صحيح ، من الممكن تمكين تعاون آلاف المطورين في مشروع واحد ، كما يمكن رؤيته في [مشروع لينوكس كيرنال] (https://github.com/torvalds/linux).

لحسن الحظ، يتكامل موقع replit.com جيداً مع github، سنستخدم ميزات git الرئيسية من داخل replit.com، وبالنسبة للمهام الأخرىمثل دمج وحل المشاكل والتعارضات، سنستخدم واجهة الويب التي يوفرها github.com لأداء هذه المهام المتعلقة بالتعاون.

استخدام github لا يكفي للتعاون بشكل فعال، لكي تكون فعالة يجب استيفاء الشروط التالية:

1. تم تنظيم الكود لتمكين التعاون (يفرض Django ذلك على المشروع بالطريقة التي ينظم بها الكود)
2. يجب أن يتفق الفريق على سير عمل يصف كيف سيبدأ كل عضو العمل ، وما يجب العمل عليه ، وكيفية مشاركته عند الانتهاء.
3. يجب على جميع أعضاء الفريق الالتزام بسير العمل عند الترميز للمشروع.

سير العمل

سيكون لكل فريق مسار عمل خاص به ، ولذا فإننا نوصي بمسار عمل لتستخدمه في هذه الدورة التدريبية. سير العمل كما يلي:

graph TD
    A[Find new Task]
    B[Create New Branch]
    C[Work on Task]
    D[Commit Work Done]
    E[Send Pull Request to Project Manager]
    A --> B
    B --> C
    C --> D
    D -- Bug Exists --> C
    D -- Task or Fix Complete --> E
    E --> A

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

1. Find a task or fix to work on: It is the responsibility of the project manager to ensure that developers can find tasks to work on. These can be found listed on GitHub issues, the ticketing system used for the project, speaking to the project manager, or reading the requirements document. For this course, project managers should write down tasks as issues in GitHub. Developers can also assist by writing issues that can either bew feature suggestions or descriptions of bugs that need to be fixed. We will discuss project management in more detail in the next section.
2. Import your project from GitHub as shown in the figure. It is also fine to import the same project again every time you want to start new work to ensure you get a fresh copy of the code.

   

   • IMPORTANT: Pull updates for existing projects: If you don;t want to import the project again and lose your work on replit, be sure to pull updates that were merged to the master branch by the project manager on GitHub. This will guarantee that you start your work with the latest version of the code

     

3. Create a new branch: Branches allow a developer to change the code without fear of ruining the project. When starting on a programming task, always create a new git branch for the task from the master branch. A branch allows you to change the code for you only, and not affect the work of others. You need to always remember the following:
   • NEVER work directly on the master branch.
   • Create a new branch from the master branch only.
   • The Master branch should always have a working copy of the project, never a broken one.
   • Choose a name for the new branch that reflects what work is done. For example bug_1234, where the number is the issue number on github. Or feature_1234. To learn about what characters are allowed in a branch name please read this article.

4. Working on the task: Ensure that the task you are working on is small and simple. If there are large and complex tasks, break them down into smaller tasks.
5. Commit the task: Upon completion of the task, or reaching a milestone in your work, you must commit the work. This would allow you to create a snapshot of the work you did to be stored in the github history. The advantage of having a commit snapshot is that you can return to this version of the code any time. Therefore, it is recommended to commit frequently and even for small changes. Just make sure when you commit that you write a useful message for the history to know what you did in that commit. You must always commit and test your work and continue to change the code and commit until you are sure that the changes you did are acceptable and the task is complete.

   

6. Send a pull request: If you are sure the task is complete then use github to send a pull request. The pull request tells the project manager that the work on this branch is complete and ready to be added to the master branch. It is the responsibility of the project manager to respond to the pull request and merge it into the master branch. The pull request can be to merge two branches from the same repository, as we will mostly do in this course. This is the case for team members working on the same repo:

It can also be used to request merging branches between forked repositories and allow you to send your work to a project that you are not a member of:

Once a pull request is created the project manager and team members can discuss this pull request and see what is done so far by the project manager regarding the matter.

Everyone is expected to follow these steps whenever you work on development projects in this course. It might seem like an overhead at first, and you will not see the benefits right away. However, the goal is to get you to practice how to code as part of a team. So when you start your final project, you will start to see the benefits of this workflow.

Git and GitHub

Know that the tool we use for asynchronous collaboration is known as Git. It allows developers to keep track of all changes done to their projects. It can be used on the developer’s computer using the command line or the GitHub desktop application. You can use it without GitHub.

GitHub is the cloud platform hosting Git services. Its a social media platform for developers built around the Git application. Because Git is so useful for developers, it is hosted for on their platform for all to use for free, provided they make their repositories public. You can pay a subscription if you wish to have private repositories. Furthermore, GitHub built a set of project management tools and social coding tools around Git. The issues, classroom, projects, pull requests, and developer profiles are not part of Git, but were added specifically for GitHub and to make coding more social. We will use many of these features to improve collaboration and for project management purposes.

There are numerous terms that you need to be aware of to use Git and GitHub effectively. We summarize them in the following table. The domain determines whether this term is specific to the Git application or has been introduced as part of the additional social features built by GitHub:

Git and GitHub Terminology