هل يشارك المطورون رتب خطوات تحديد مكان الزر في التوثيق؟
2026-02-24 11:02:44
218
Folgen22
Teilen
جوادتتذكر
قارئ شغوف
محاسب
ABO-Persönlichkeitstest
Mach einen kurzen Test und finde heraus, ob du Alpha, Beta oder Omega bist.
Duft
Persönlichkeit
Ideales Liebesmuster
Geheimes Verlangen
Deine dunkle Seite
Test starten
5 Antworten
Owen
قارئ شغوف
محام
لا توجد قاعدة واحدة تُطبّق على كل المشاريع، وأكبر مؤشر بالنسبة لي هو إن كان الفريق يهتم بالاختبار الآلي أو بدعم العملاء.
في المشاريع التي أعمل معها وأحبها، المطوّرون يشاركون 'رتب' واضحة في التوثيق عندما تكون الواجهة حرجة لتجربة المستخدم أو تتكرر عبر مسارات عديدة داخل التطبيق. هذه الرتب تظهر على شكل خطوات قابلة للتنفيذ، لقطات شاشة، وأحيانًا مسارات CSS أو قيم data-test-id حتى يسهل على فريق الاختبار كتابة سيناريوهات. أما في المشاريع ذات التطوير السريع أو التي تعتمد على تحديثات متكررة فلن ترى تلك الخطوات مكتوبة بشكل منهجي؛ بدلاً من ذلك قد تجد أمثلة كود ونماذج تفاعلية في 'Storybook'.
شخصيًا أفضّل التوثيق الذي يجمع بين الاثنين: خطوات واضحة للمستخدمين وبيانات تقنية للمختبرين، لأن ذلك يقلل الالتباس ويفسح المجال لصيانة أسهل على المدى الطويل.
2026-02-25 06:17:16
2
Wyatt
قارئ وفي
صيدلي
أصادف كثيرًا مستندات توضح أماكن الأزرار بصورة سردية أو بصور ثابتة، لكن نادرًا ما تلتزم الفرق بترتيب خطوات رسمي واحد في التوثيق.
في مشروعي السابق كان التوثيق يختلط بين دليل واجهة المستخدم العام، وشروحات للمكوّنات في 'Storybook'، وحالات اختبار للـ QA تحتوي على خطوات مفصلة مثل "افتح القائمة > انتقل إلى الإعدادات > اضغط على الزر"، بينما المستند التقني قد يذكر فقط اسم الـ selector أو قيمة data-test-id. لذلك، إذا كنت تبحث عن رتب خطوات واضحة فالأرجح أن تجدها في ملفات الاختبار أو دليل المستخدم العملي، أما التوثيق التقني فغالبًا يركّز على العناصر القابلة للاختبار بدلاً من خطوة-بخطوة للمستخدم.
أختتم بأمر عملي: إذا التوثيق غير كافٍ، أنصح بالبحث في 'Storybook'، أو فحص DOM، أو سؤال زميل سريعًا — هذه الخطوات أنقذتني مرات عديدة عندما لم تكن التوثيقات مرتبة كما أحتاج.
2026-02-25 12:03:15
7
Walker
محب روايات
معلم
ما تريده فعلاً عادةً يوجد في مكانين: دليل المستخدم أو سيناريوهات الاختبار، وليس دائماً في التوثيق التقني.
في المشاريع التي تعاملت معها، المطوّرون يكتبون خطوات مُرتّبة عندما يكون للزر دور وارد في عمليات دعم العملاء أو في اختبارات القبول. وإذا لم تجد ذلك، فاستخدام أدوات مثل فحص العناصر في المتصفح، أو البحث عن 'data-test-id' في الشيفرة، أو التوجه إلى 'Storybook' غالبًا يوفّر لك المسار العملي للوصول إلى الزر. في النهاية، وجود سجل واضح للخطوات يسهل العمل للجميع، ومن تجربتي هو استثمار يوفّر وقتًا كبيرًا لاحقًا.
2026-03-01 08:03:18
4
Lucas
عاشق روايات
طبيب بيطري
الواقع أن الفرق الصغيرة أو المشاريع المفتوحة المصدر لا تميل عادةً إلى نشر رتب خطوات مفصلة داخل التوثيق، لأن صيانتها تحتاج وقتًا وجهدًا.
في حالات كثيرة أجد أن ما يتوفر هو وصف للمكوّن، أمثلة للاستخدام، وربما خاصية تُسمى data-test-id أو اسم كلاس يمكن البحث عنه. هذا يكفي للمطورين المعتادين، لكن قد يكون محبطًا لمن لا يعرف البنية الداخلية للتطبيق. لذا أميل للبحث داخل ملفات الاختبار أو استكشاف 'Storybook' أولًا قبل أن أتكبد عناء قراءة مستندات مفصلة قد تكون قديمة.
2026-03-02 00:54:59
7
Fiona
مساعد
طبيب
دوماً ألحظ أن الإجابة تعتمد على نوع المشروع والذوق التنظيمي للفريق؛ في بعض الشركات يعطي المطوّرون قائمة مرتّبة بخطوات للوصول إلى زر معين لأن ذلك يسهل على فرق الاختبار والدعم وخدمة العملاء. هذه القوائم قد تأتي ضمن ملفات اختبار تلقائية أو مستندات قوالب الدعم الفني، وتشمل أحيانًا لقطات شاشة ومسارات القوائم وحتى أسماء الـ selectors أو القيم الخاصة بـ data attributes.
من ناحية أخرى، هناك فرق ترى أن تكرار خطوات واجهة المستخدم في التوثيق يخلق عبئًا في الصيانة خصوصًا إذا كانت الواجهة تتغير كثيرًا؛ في هذه الحالة يكتفون بوصف المكوّن وطرح مثال في الكود، ويفترضون أن المطور سيستخدم أدوات مثل 'Storybook' أو أدوات التفتيش داخل المتصفح لتحديد مكان الزر. بناءً على ذلك، إن احتجت ترقيم واضح للخطوات فالأرجح أن تستخرجه من ملفات الاختبار أو من دليل المستخدم بدل التوثيق التقني الصريح.
2026-03-02 05:04:57
2
Alle Antworten anzeigen
Code scannen, um die App herunterzuladen
Verwandte Bücher
طرق منفصلة، قاتلت من أجلها
فيلفيت
0
1.7K
حدقت في عقد الزواج المدبر من قبل عائلة فيرسيتي الذي دفعه والدي عبر الطاولة.
دون تردد، كتبت اسم أختي غير الشقيقة، ديمي، وأعدته إلى جانبه.
تجمد والدي في مكانه. ثم أضاءت عيناه بحماسة سخيفة، كما لو أنه فاز باليانصيب.
"كيف يمكنك أن تعطي مثل هذه الفرصة المثالية لأختك؟"
في حياتي السابقة، كان زواجي مزحة للجميع من حولي.
كنت تلك الساحرة الصغيرة الجامحة ذات الشعر الأحمر، التي تجرأت على دخول مدار كاسيان فيرسيتي، الوريث وزعيم عائلة فيرسيتي الإجرامية ذات الدماء القديمة.
لم أكن يومًا مثالية ولا مطيعة.
هو كان يحب فساتين الآلهة. أما أنا فكنت أرتدي التنانير القصيرة وأرقص على الطاولات.
لقد طالب بعلاقة حميمة تبشيرية وتقليدية ومنظمة. بينما أردت أن أصعد فوقه، وأمتطيه، وأفقد نفسي تمامًا.
في حفلٍ فاخر، كانت زوجات المجتمع الراقي يضحكن على شعري، وفستاني، و"تهوري".
كنت أعتقد أنه على الأقل سيتظاهر بالدفاع عني.
لكنه لم يفعل.
"سامحيها. هي ليست... مدربة بشكل صحيح."
مدربة.
كما لو كنت كلبًا.
قضيت حياتي الماضية وأنا أختنق تحت قواعده، أُشوه نفسي لأتطابق مع الشكل الذي يريده، حتى ليلة اندلاع الحريق في منزلنا.
عندما فتحت عيني مجددًا، كنت في اللحظة التي علمت فيها بالزواج المدبر.
نظرت إلى العقد أمامي.
هذه المرة؟
أعتقد أن شباب النوادي الليلية يناسبونني أكثر.
لكن اللحظة التي أدرك فيها كاسيان أن العروس لم تكن أنا، حطم كل قاعدة كان يعيش وفقها طوال حياته.
دعا زياد المنصوري جميع أصدقائه للاحتفال بالذكرى الثالثة لزواجه من ليان رشدي.
لكن فور وصولها إلى مكان الاحتفال، رأت زياد جاثيًا على ركبة واحدة، يطلب الزواج من صديقة طفولته.
سألته بهدوء يكتم غضبًا.
لكنه أجابها بنفاد صبر: "مجرد تحدي في لعبة ليس أكثر!"
لم تفيق إلا بعد أن دفعها من أعلى الدرج، من أجل صديقة طفولته، ففقدت جنينها.
"زياد، فلنتطلق"
كبح رابطتنا سبع مرات، وفي المرة الثامنة أنا من قطعتها
نوري
0
1.2K
"تشعر دارسي بالدوار الليلة. لنكبح رابطتنا يا إيما، ويمكننا إقامة مراسم الوسم في يوم آخر."
كانت تلك هي الكلمات نفسها التي ألقاها في وجهي عندما اتصلت به في اليوم الذي كان يُفترض أن يكون يوم مراسم وسمنا.
وكانت هذه هي المرة السابعة التي يطلب مني فيها كبح رابطتنا المقدرة من أجل حبيبة طفولته.
في المرة الأولى التي كبح فيها الرابطة، كان السبب أن قطيع دارسي تعرض لهجوم وأراد أن يكون إلى جانبها، وقال حينها: "دارسي تقاتل من أجل بقائها، وأنتِ تريدين أن تجذبني رابطتنا المقدرة إليكِ؟ لا تدفعيني للاعتقاد بأنكِ بهذا القدر من الأنانية يا إيما."
وفي المرة الثالثة التي كبح فيها الرابطة، قال: "دارسي تعاني من الحمى، ولا يمكنني تركها وحدها."
وبحلول المرة السادسة، لم يكلف نفسه عناء شرح سبب استعانته بالساحرة لكبح رابطتنا بأكثر الطرق وحشية، لأنه كان في عجلة من أمره للقاء دارسي.
وبما أننا كنا رفيقين مقدرين، ففي كل مرة كان يرغب في مشاركتها لحظات حميمة كان يستعين بساحرة لكبح الرابطة بيننا.
ولكوني أوميغا، كان هذا الكبح يسبب لي ألمًا شديدًا يجعلني عاجزة عن مغادرة فراشي لأسابيع، بينما لم يكن يؤثر فيه تقريبًا بصفته ألفا.
ورغم أنه كان يبدو محطمًا لرؤيتي أتألم بهذا الشكل، إلا أنه لم يكن يقدم لي سوى بضع كلمات اعتذار، وحفنة من الوعود بأنه سيعوضني في المستقبل. هذا كل شيء.
لذا، عندما رفض وسمي للمرة السابعة، وعاد إلى المنزل لكبح رابطتنا ليكون مع دارسي، كنت قد حزمت أمتعتي بالفعل.
ستكون هذه المرة الأخيرة التي يكبح فيها رابطتنا، لأنه في المرة القادمة لن تكون هناك رابطة بيننا ليكبحها.
الأم هى الصخرة التي تقف متأهبة من أجل إسنادك، هى الصديق الحقيقي الذي يزيذ في وفاءه لك ولا يتغير مع تغير وتقلب الزمان ، هى النجمة اللامعة في العالم المظلم المحيط بك وبغض النظر عن صعوبة الأمور في بعض الأحيان الا أنها تظل دائمًا موجودة من أجل الحماية والدفاع عن أولادها فهى جنة الله فالأرض فنبع حنانها يفيض ، فهى تعطي دون النظر إلى اي مقابل.
اللهم أجعل أمي من سيدات أهل الجنة واحفظها من كل سوء وأمهات الجميع.
آمين يا رب العالمين ،،
فتاة متخصصة في إدارة نظم المعلومات (MIS)، تُجبر على زواج لا ترغب فيه، وبدلًا من الاستسلام أو المواجهة التقليدية تقرر التعامل مع الزواج كـ "منظومة عمل" أو "عقد رقمي" وتبدأ بذكاء شديد في دراسة وثيقة الزواج والالتزامات الاجتماعية لإيجاد ثغرات وخرق البنود بشكل منظم يجبر الطرف الآخر على الانهاء من قبله
ولكن ...............
صديقها هو ورغم هذا حبه لها بلا حدود ولكن عندما ترفضه أكثر من مره، لا يجد أمامه سوا اللجوء إلي خطبه مزيفه، يجذب بها غيرتها وعشقها وتملكها له
وتكتشف هي الحب المخفي داخل قلبها لصديقها منذ الطفوله
قرأت الدليل بعناية وأستطيع القول إنه يضع بنية واضحة لخطوات تحديد مكان الزر، لكن التطبيق العملي يحتاج بعض الإضافات الصغيرة لتصبح العملية سلسة حقًا.
النصوص تشرح الرتب أو المراحل بشكل منطقي: بدايةً من تعريف الهدف، ثم البحث عن المراجع البصرية أو التخطيط الأولي، يليها اختبار المواضع المقترحة وتقييم سهولة الوصول. ما أعجبني هو وجود نقاط مرجعية لكل مرحلة تساعد على ترتيب الأفكار وعدم القفز بين الخطوات. لكن الدليل يبقى عامًا في بعض النقاط العملية؛ مثلاً لم أجد أمثلة مصورة توضح قياسات المسافات أو زاوية الوصول لأيدي مختلفة، وهذا مهم لو أردت تنفيذ الفكرة على أرض الواقع.
لو كنت أطبق الدليل الآن، سأضع قائمة تحقق لكل رتبة: أدوات القياس، معايير الراحة، سيناريوهات المستخدم المختلفة، وخطة اختبار ميداني. بذلك تتحول النظريات إلى عمل مادي قابل للتكرار والقياس. في النهاية، الدليل رائع كإطار عمل، ويحتاج فقط لقوالب وتطبيقات عملية ليصبح دليلًا عمليًا بالكامل.
أول ما أفكر فيه عند تحديد مكان زرّ في واجهة هو تقسيم العملية إلى خطوات عملية ثم اختيار الأدوات التي تخفف العناء في كل خطوة.
أبدأ عادة بأدوات التصميم السريع مثل برنامج التصميم التعاوني الذي أفضله لوضع الشبكات والمواقع النسبية للأزرار، ثم أنتقل إلى أدوات النمذجة التفاعلية لنتأكد أن موضع الزر يعمل على الشاشات المختلفة. بعد ذلك أستخدم أدوات المتصفح (أدوات المطور) لاختبار DOM وCSS وتعديل المواضع مباشرة، وأقيس الصناديق الضابطة عبر getBoundingClientRect لأخذ الإحداثيات الحقيقية.
أحب أيضاً إضافة طبقة تحليلية بالاعتماد على أدوات السجل الحراري وتحليلات الاستخدام لفهم أين يضغط الناس فعلاً، ومع أدوات اختبارات الوصول مثل مدقق 'axe' وLighthouse نتحقق من أن الزر يظهر في شجرة الوصول ويملك تسميات ARIA مناسبة. أختم دائماً بتجارب يدوية على أجهزة فعلية وأتمتة بسيطة للاطمئنان على التوافق والموضع النهائي.
أضع دائماً خريطة أولية لتدفق المستخدم قبل أن أقرر مكان وضع أي زر.
أبدأ بتحديد الهدف الرئيسي من الشاشة: ما هي أهم وظيفة يريد المستخدم إنجازها؟ أعرّف الإجراء الأساسي وأضعه في مركز الاهتمام بصرياً ووظيفياً. بعدها أقيّم السياق: هل الشاشة تُستخدم أثناء الوقوف أو أثناء التنقل؟ هل المستخدم يحرك الهاتف بيده اليمنى أم اليسرى؟ هذه التفاصيل تُغيّر فكرة «منطقة الإبهام» وتؤثر على اختيار الموقع.
أجري اختباراً سريعاً عبر رسم إطارات ورقية أو نموذج تفاعلي بسيط لوضع الأزرار وتجربة مسارات الوصول. أُراكم نتائج ملاحظات المستخدم وأعدل توازن المساحة، الحجم، واللون حتى يصبح الزر واضحاً دون أن يطغى على المحتوى. أخيراً أتحقق من الاتساق مع نمط التطبيق وأُدخِل اختبارات صغيرة (A/B) وقياسات استخدام حقيقية للتأكد من أن الموقع يؤدي فعلاً إلى تقليل الأخطاء وزيادة الفاعلية.
أرى أن التفاصيل الصغيرة مثل ترتيب الزر لها تأثير أكبر مما يتوقعه الكثيرون.
عندما أتعامل مع واجهات، ألاحظ كيف أن وضع الأزرار بشكل متدرج ومنطقي يخفف العبء الذهني على المستخدم. ترتيب الخطوات لتحديد مكان الزر يعني أنك لا تترك المستخدم يتخبط بحثًا عن الإجراء الصحيح؛ بل توجهه بعناية من الخيار الأكثر أهمية إلى الأقل، وهذا يقلل الأخطاء ويزيد من الشعور بالسيطرة. أحب أن أختبر هذا عمليًا: أستخدم تدرج اللون والحجم والموضع لتمييز الإجراء الأساسي، ثم أختبر النسخ البديلة عبر اختبارات A/B لأرى تأثير الترتيب على معدل الإكمال.
كما أن الترتيب المدروس يسهل الوصولية؛ أضمن أن الأزرار الهامة قريبة للأصابع على الشاشات الصغيرة، وأنها قابلة للوصول عبر لوحة المفاتيح أو قارئ الشاشة. في النهاية، التجربة تصبح أكثر سلاسة عندما يشعر المستخدم أن كل شيء مُرتّب ومُبرر، وهذا يجعلني أقدر العمل على تفاصيل كهذه أكثر من أي تأثير بصري ضخم.
أحب أن أتصور العملية كسباق له عدة محطات واضحة قبل الوصول لخط النهاية.
أنا عادةً أجزئ مهمة 'تحديد مكان الزر' إلى خطوات عملية: جمع المتطلبات والمشهد (ساعتان إلى نصف يوم)، مسح الموقع أو واجهة المستخدم فعليًا ورسم خرائط سريعة (من بضع ساعات إلى يوم)، تنفيذ نموذج أو بروتوتايب سريع للتموضع (نصف يوم إلى يوم كامل)، اختبار ميداني أو وظيفي للتأكد من سهولة الوصول والتأثير (نصف يوم إلى يوم)، ثم ضبط نهائي وتوثيق ودمج التغييرات (يوم إلى ثلاثة أيام بحسب التعقيد).
في أبسط الحالات، عندما تكون الرؤية واضحة والأدوات متوفرة، يمكن أن ينتهي الفريق خلال يوم إلى ثلاثة أيام عمل. في الحالات المتوسطة التي تتطلب اختبار مستخدم أو موافقات داخلية، أتوقع من ثلاثة إلى سبعة أيام. أما لو احتجنا تعديلات في التصميم، معدات جديدة، أو موافقات أمان/تنفيذ، فقد تمتد العملية لأسبوعين أو أكثر. أنا أميل دائمًا لإضافة هامش احتياطي 20-30% لتفادي المفاجآت، لأن ما يبدو بسيطًا غالبًا ينكشف عنه تفاصيل صغيرة في الميدان.
كنت لاحظت أن كلمة 'داتا' تتحوّل في فم الناس إلى شيء مرن جدا؛ في التوثيق عادةً تُستخدم بتعريف واضح ومحدّد، بينما في الشغل اليومي المطورين يتعاملون معها بمرونة أكبر. عندما أقرأ توثيق رسمي، أجد أن 'الداتا' تُقسَّم: حقل، سجل، نموذج، مخطّط، وأنواع بيانات واضحة — وهذا مهم ليتفق الجميع على الشكل والسلوك.
في الواقع العملي، المطوّر قد يقول 'أضفت داتا' ويقصد أي شيء من إعدادات، لقطة شاشة، قياس لأداء، أو كائن JSON عائم. السبب ببساطة أن في الكود تتداخل المسؤوليات: قاعدة بيانات، كاش، لوجات، وحتى متغيّرات بيئة تُستعمل كلها كـ 'داتا'. لذلك أرى فجوة بين لغة التوثيق الدقيقة ولغة الفريق اليومية. الحل العملي اللي أحبّه هو الاتفاق على مصطلحات داخل المشروع: ماذا نعني بـ 'داتا خام' و'داتا معالجة' و'ميتاداتا'، وكتابة أمثلة فعلية في التوثيق لتقريب المفهوم. هذا يخفف الالتباس ويجعل التوثيق أقرب إلى واقع الاستخدام، وهو شيء أحب رؤيته في المشاريع الناجحة.
كنت أتذكر مشهد المطاردة في فيلم 'The Town' بطريقة مفصلة جدًا، حيث البطل 'دوغ ماكراي' يوجه الشرطة إلى مستودع في 'شارع هانوفر'، تحديدًا المبنى رقم 42. هذا المكان لم يكن مجرد مستودع عادي — كان متهالكًا ومغطى بالجرافيتي، وكأنه جزء من تاريخ الجريمة في بوسطن. تذكرت كيف كانت الكاميرا تركز على اللوحة الصدئة للمستودع، وكيف أن صوت صفارات الإنذار كان يقترب ببطء.
ما جعل هذا المشهد لا يُنسى هو أن البطل لم يخبرهم بالعنوان مباشرة، بل قال شيئًا مثل 'في النهاية الشرقية، بجانب مصنع الطوب المهجور'. وهذا جعل الشرطة تتجول قليلاً قبل أن تجده. بالنسبة لي، كان هذا تفصيلاً ذكيًا يضيف واقعية، لأن المجرمين نادرًا ما يقدمون إحداثيات دقيقة. في النهاية، أظن أن المخرج أراد أن يُظهر أن حتى في لحظات الخيانة، هناك مساحة من الغموض.
عشت هذا المشهد وكأني هناك، خاصة مع الموسيقى التصويرية المثيرة. ربما هذا هو السبب في أن 'The Town' يظل أحد أفلام السرقة المفضلة لدي — كل تفصيلة صغيرة تخدم القصة.
خلال متابعتي لقضايا الزواج والوثائق، لاحظت أن إجراءات توثيق الزواج لدى المحاكم تتكوّن من خطوات واضحة لكنها تختلف بتفصيلاتها حسب المكان، فهنا أشرحها خطوة بخطوة بطريقة عملية.
أولاً جهزتُ المستندات الأساسية: بطاقتي الشخصية وجواز السفر إن وُجد، صورة شخصية لكل طرف، شهادة ميلاد إن طُلِبت، وإثبات الإقامة. إذا كان هناك طلاق سابق أو وفاة زوج سابق فحضرتُ صك الطلاق أو شهادة الوفاة. كما أعددتُ عقد النكاح (المكتوب) الذي يذكر المهر وشروط النكاح، وتأكدتُ من توقيع الشهود ووجود الولي في حالة الحاجة حسب المذهب والقانون المحلي. في بعض الدول يطلبون فحصًا طبيًا أو شهادة عدم ممانعة من السفارة للزواج الدولي، فتركتُ نسخًا إضافية من كل وثيقة.
ثم ذهبتُ إلى المحكمة أو المحكمة الشرعية المختصة وقدمتُ طلب تسجيل الزواج مع كل المستندات. المحكمة تتحقق من الهوية، وتثبت وقوع العقد عبر عقد مسجل أو شهادة القائم على النكاح، وقد تستدعي الشهود لتأكيد النكاح إذا لزم. بعد المصادقة تُصدر المحكمة قيدًا رسميًا للزواج أو تُحوّل القيد إلى الدائرة المدنية لتسجيل الحالة المدنية. في النهاية تحصلتُ على صك الزواج الرسمي أو شهادة تسجيل الزواج التي تثبت الوضع القانوني وتتيح استخراج أوراق مثل دفتر العائلة أو تعديل الحالة في السجلات.
نصيحتي العملية: اطلع دائمًا على متطلبات المحكمة المحلية قبل الذهاب، واحمل نسخًا مترجمة إذا كانت الوثائق بلغة أجنبية، واحتفظ بنسخ موثقة من العقد والشهود لأن التفاصيل الصغيرة قد تطيل الإجراءات إذا لم تكن جاهزة. هذه التجربة علّمتني أن التنظيم يُختصر الكثير من الوقت والجهد.