تخطي إلى المحتوى الرئيسي

إرشادات الدليل

شعار الأدلة

لضمان بقاء المحتوى في ZAP-Docs دائمًا متسقًا من حيث الجودة والأسلوب، أنشأنا مجموعة من الإرشادات لاستخدامها عند إنشاء أو تعديل المحتوى الخاص بتوثيقنا. يجب عليك اتباع إرشاداتنا بدقة لضمان معالجة اقتراحك وطلب السحب النهائي بسرعة. والأهم من ذلك، سيضمن هذا أن يحصل قراؤنا على تجربة أفضل وأكثر اتساقًا وعالية الجودة أثناء قراءة الأدلة ومتابعتها.

تنقسم إرشادات مساهمات الأدلة إلى الأقسام التالية:

  • الهيكل
  • الأسلوب
  • التنسيق
  • المصطلحات

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

الهيكل

جميع أدلتنا عبر ZAP-Docs تتبع هيكلًا متسقًا نسبيًا يبدأ بمقدمة قصيرة مع أي متطلبات مسبقة أو خطوات تحضيرية، تليها المحتوى الرئيسي وخاتمة قصيرة.

يمكن تعديل الهيكل أحيانًا حسب نوع الدليل المنتج. يمكن مناقشة ذلك مع فريق ZAP-Docs ضمن اقتراحك الأولي. يمكنك الاطلاع على كيفية استخدام العناوين عبر قسم العناوين، ويتم ذلك من خلال Markdown التقليدي.

الهيكل الذي نتوقع رؤيته عادةً يحتوي على العناوين التالية:

  • عنوان الصفحة (H1) - يتم تعيينه عبر بيانات التعريف title في أعلى الصفحة.
  • مقدمة (H2) - جملة أو جملتان موجزتان تشرح موضوع الدليل والأهم توضح ما يهدف الدليل لتحقيقه.
  • التحضير (H2) - هذا العنوان اختياري. يُستخدم فقط إذا كانت هناك متطلبات مسبقة أو خطوات تحضيرية يجب تنفيذها قبل أن يتمكن القارئ من متابعة الدليل. على سبيل المثال، هنا يمكنك الإشارة إلى دليلنا الوصول الأولي عبر SSH إذا كان يجب على المستخدم تسجيل الدخول إلى سيرفره أولاً. أو يمكنك عرض أي متطلبات برمجية و/أو عتادية. أو تقديم تعليمات سريعة حول كيفية إعداد بعض البرمجيات، مثل جدار ناري. ننصح بتصفح موقع ZAP-Docs لمعرفة ما إذا كانت هناك أدلة تغطي هذه الخطوات وإذا كان الأمر كذلك، قم بربطها.
  • الموضوع الرئيسي (H2) - هذا هو القسم الرئيسي الأول في الدليل. في كثير من الحالات، سيكون بعنوان التثبيت، يليه عدة أقسام فرعية لكل جزء من العملية. لكن قد لا يكون هذا هو الحال دائمًا، فالأدلة المعلوماتية قد يكون لها موضوع رئيسي مختلف.
  • اختياري: موضوع فرعي 1 (H3)
  • اختياري: موضوع فرعي 2 (H3)
  • ...
  • اختياري: موضوع آخر (H2)
  • الخاتمة (H2) - كجزء نهائي من الدليل، يجب أن تختم الدليل في 1-3 جمل تشرح ما حققه القارئ بنجاح وتوفر مرجعًا لفريق الدعم إذا كان القارئ لا يزال يواجه مشاكل.
استخدام العناوين الفرعية (H3 و H4)

نشجعك على استخدام عناوين H3 لإنشاء أقسام فرعية داخل أقسام H2 الرئيسية لتنظيم المحتوى الأكبر إلى أقسام منظمة. يمكن رؤية مثال على ذلك في قسم الموضوع الرئيسي أعلاه.

يمكنك أيضًا استخدام عناوين H4. هذه مفيدة إذا أردت إنشاء قسم فرعي آخر دون عرضه في تقسيم القسم على الجانب الأيمن من الدليل. كما أنها مفيدة إذا كنت بحاجة لتقسيم قسم H3 إلى أقسام أصغر.

إذا كنت تستخدم العناوين الفرعية، فمن المنطقي عادةً أن يكون هناك عنوانان فرعيان أو أكثر ضمن العنوان الرئيسي، وإلا فلن يكون من المنطقي وجود عنوان فرعي واحد فقط ضمن عنوان رئيسي.

في المستقبل، سنضيف قوالب تحتوي على Markdown معد مسبقًا لك، والتي ستكون نقطة انطلاق مفيدة لإنشاء صفحات جديدة. سيتم إضافتها قريبًا.

العناوين

يجب أن تكون العناوين مختصرة وتعكس بوضوح الهدف الأساسي من الدليل. فكر فيما سيحققه القارئ في النهاية، مثل إكمال التثبيت، تكوين خدمة، أو فهم موضوع تقني محدد. يجب أن يكون الهدف واضحًا من العنوان نفسه.

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

على سبيل المثال، دليل متعلق بمنتج VPS يجب أن يتبع هيكل مثل: VPS: إعداد SteamCMD على لينكس.

إذا كُتب الدليل بطريقة عامة وينطبق على عدة منتجات، مثل خدمة أو تثبيت سيرفر ألعاب يعمل على كل من VPS و سيرفر مخصص، فلا يجب تضمين اسم المنتج في العنوان. في هذه الحالات، يكون الدليل مستقلًا عن المنتج ولا يحتاج إلى بادئة محددة.

المقدمة

يجب أن تكون مقدمات أدلتك قصيرة ومباشرة، عادة ما تكون من 1-2 جمل. في المحتوى، يجب أن تهدف إلى وصف موضوع الدليل بإيجاز والأهم توضيح ما سيقدمه الدليل للقارئ، مع إعلامه بالهدف النهائي.

مثال على مقدمة مثالية لدليل متعلق بـ SteamCMD:

  • الجملة الأولى: SteamCMD هي أداة أساسية ضرورية لتثبيت سيرفرات مخصصة لمجموعة واسعة من الألعاب مثل Palworld و Enshrouded والمزيد.
  • الجملة الثانية: في هذا الدليل، سنستعرض عملية الإعداد لأول مرة لتثبيت SteamCMD على سيرفر لينكس الخاص بك. سنستخدم Ubuntu في الأمثلة، لكن العملية ستكون مشابهة جدًا للتوزيعات الأخرى.

كما هو واضح في المثال، تلخص المقدمة باختصار المواضيع ذات الصلة في هذا الدليل وتعرض الهدف العام للقارئ عند إتمام الدليل.

التحضير

قسم التحضير مفيد لتوضيح أي متطلبات مسبقة يجب على القارئ تلبيتها قبل أن يتمكن من متابعة الدليل. قد تكون هذه متطلبات برمجية أو عتادية، تعليمات لإعداد بعض البرمجيات مثل جدار ناري، أو ببساطة توجيه المستخدم لتسجيل الدخول إلى سيرفره عبر SSH أو RDP.

ننصح بشدة بتصفح موقع ZAP-Docs للبحث عن أدلة قد تغطي أو ترتبط بأي خطوات تحضيرية تخطط لإدراجها. إذا كان هناك دليل يغطي موضوعًا، مثل الوصول الأولي عبر SSH، يجب ربط الدليل وإبلاغ القارئ بمتابعته قبل المتابعة.

المتطلبات الشائعة للأدلة تشمل:

  • البرامج المطلوبة (مثل Git، Node.js، Python، Docker)
  • دروس قد تساعد القارئ على اكتساب معرفة أساسية (مثل صفحة أخرى من ZAP-Docs)
  • حسابات المستخدم مثل APIs
  • الإعدادات المطلوبة (مثل DNS/SSL)

مثال على ذلك لدليل Reverse Proxy سيكون:

لإعداد reverse proxy ستحتاج إلى سيرفر لينكس لاستضافة سيرفر البروكسي ويجب أن تتصل به. استخدم دليلنا [الوصول الأولي عبر SSH](vserver-linux-ssh.md) إذا كنت بحاجة للمساعدة في ذلك. ستحتاج أيضًا إلى الوصول إلى نطاق تملكه. لكل نطاق فرعي تخطط لاستخدامه، يجب إنشاء سجل DNS من نوع `A` يشير إلى عنوان IP الخاص بسيرفر لينكس.

الموضوع الرئيسي

حان الوقت الآن لكتابة الجزء الأكبر من دليلك. يمكنك استخدام عناوين H2 و H3 و H4 لتنظيم دليلك بشكل مناسب. من المنطقي استخدام عناوين H2 للأقسام الكبيرة وتقسيمها إلى أقسام فرعية باستخدام H3 و/أو H4.

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

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

مثال على هذه العبارات:

  • عبارة الدخول: في هذا القسم، ستقوم بعملية التكوين لتخصيص البرمجيات حسب رغبتك.
  • عبارة الإغلاق: مع إعداد التكوين وحفظ الملف، انتقل إلى القسم التالي لإعداد حساب المسؤول وبدء استخدام البرمجيات.

من خلال هذه العبارات الانتقالية، يحصل القارئ على سياق مهم يضمن تدفق الدليل بشكل جيد. تذكر، يجب عليك دائمًا استخدام صيغة المخاطب (مثل "ستقوم بإنشاء") بدلاً من صيغة المتكلم عند كتابة المحتوى والانتقالات.

الخاتمة

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

من الجيد ربط أي أدلة موجودة في ZAP-Docs هنا، خاصة إذا كانت تتبع منطقيًا من دليلك. كما نوصي بتوفير مرجع لفريق الدعم إذا كان القارئ لا يزال يواجه مشاكل.

مثال على خاتمة رائعة هو:

لقد قمت الآن بإعداد البرمجيات لتعمل على سيرفر لينكس الخاص بك بنجاح! ننصح بتصفح أدلة خدمات لينكس الموجودة في هذا القسم لتثبيت خدمات إضافية.

لأي أسئلة أو مساعدة، لا تتردد في التواصل مع فريق الدعم لدينا، المتوفر يوميًا لمساعدتك! 🙂

الأسلوب

أسلوب الكتابة في وثائق ZAP-Hosting يتبع إيماننا بإنتاج أدلة عالية الجودة، عملية وسهلة الوصول لدعم مجموعة واسعة من المواضيع ودعم القراء من جميع مستويات الخبرة.

تقني وصحيح

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

يجب على الكتاب دائمًا مراجعة واختبار أدلتهم لضمان أن كل شيء صحيح تقنيًا ويعمل كما هو مقصود قبل تقديم طلب السحب. سيقوم فريق وثائق ZAP-Hosting بقراءة واختبار دليلك حيثما كان مناسبًا لضمان اتساقه وصحته الواقعية أو مناقشة التحسينات إذا وُجد خطأ.

نصيحة

ننصح دائمًا كتابنا بتمرير المحتوى عبر أداة تدقيق إملائي لضمان صحة القواعد والإملاء قبل إنشاء طلب السحب. موقع مفيد لذلك هو: https://languagetool.org/

عملي ومفيد

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

ودود، رسمي وشامل

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

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

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

التنسيق

توثيقنا منسق باستخدام لغة Markdown التي تُستخدم على نطاق واسع وبسيطة نسبيًا. اطلع على الأقسام أدناه لفهم ما نستخدمه وكيف نستخدمه.

نصيحة

لمزيد من الأمثلة والشروحات الموسعة لميزات Markdown، توجه إلى دليل Markdown الذي يوفر معلومات إضافية.

العناوين

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

في أدلتنا، يجب استخدام عناوين H2 لتقسيم الدليل إلى أقسامه الرئيسية. بعد ذلك، تُستخدم عناوين H3 لتقسيم الأقسام الرئيسية إلى أقسام فرعية. مثال على ذلك هو تقسيم قسم رئيسي إلى عدة خطوات لتسهيل متابعة الدليل. أخيرًا، هناك أيضًا علامة H4 التي تُستخدم نادرًا في توثيقنا لكنها تخدم نفس الغرض في تقسيم الأقسام الفرعية، لكنها لن تظهر في هيكل الدليل.

معلومات

إذا كنت تستخدم العناوين الفرعية (مثل عناوين H3 تحت عناوين H2 الرئيسية)، يرجى التأكد من وجود عنوانين أو أكثر من نفس المستوى ضمن ذلك القسم، وإلا فسيكون الاستخدام غير صحيح.

إليك مثال سريع على كيفية استخدام العناوين:

## التثبيت
H2 - القسم الرئيسي

### تحميل ملفات اللعبة
H3 - قسم فرعي من H2

#### عبر SteamCMD
H4 - قسم فرعي من H3

#### يدويًا عبر GitHub
H4 - قسم فرعي من H3

### إعداد التكوين
H3 - قسم فرعي من H2

### تشغيل السيرفر
H3 - قسم فرعي من H2

تنسيق Markdown داخل السطر

نستخدم مجموعة من التنسيقات داخل السطر لتحسين قابلية قراءة أدلتنا وتناسب القراء بمستويات تقنية مختلفة. اقرأ القسم أدناه لفهم استخدام كل منها.

النص العريض

الاستخدام الرئيسي للنص العريض هو لتأكيد المعلومات. أمثلة على ذلك تشمل:

  • تغيير السياق بين الخطوات
  • أسماء المضيفين، بيانات الاعتماد وأسماء المستخدمين
  • المصطلحات الرئيسية

يمكنك ببساطة استخدام نجمتين مزدوجتين خارج النص المستهدف لجعله عريضًا، على سبيل المثال، **مرحبًا هناك** ينتج مرحبًا هناك.

النص المائل

الاستخدام الأساسي للنص المائل هو تقديم كلمات تقنية جديدة داخل مقالك. على سبيل المثال، سنقوم بإعداد reverse proxy اليوم.

لاستخدام النص المائل، ضع نجمة واحدة خارج النص المستهدف، على سبيل المثال، *ZAP-Hosting - المزيد من القوة!* ينتج ZAP-Hosting - المزيد من القوة!.

كود داخل السطر

يُستخدم تنسيق الكود داخل السطر بشكل رئيسي لعرض معلومات تقنية مثل عناوين URL. قائمة أكثر شمولاً تشمل:

  • أسماء ومسارات الملفات (مثل C:/User/[your_name]/AppData....test.png)
  • عناوين URL (مثل https://zap-hosting.com)
  • المنافذ (مثل :30120)
  • الأوامر (مثل ipconfig)
  • استعلامات SQL (مثل SELECT * FROM servers)
  • اختصارات المفاتيح والضغطات (مثل ENTER أو CTRL + C)

الجداول

ميزة Markdown المفيدة الأخرى هي الجداول. يمكن أن تكون مفيدة بشكل خاص عند الحاجة لعرض كمية كبيرة من المعلومات المتكررة، مثل الأوامر، الوصف والاستخدامات المتاحة داخل لعبة. المثال التالي يوضح استخدام الجدول:

| الأمر       | الوصف                   | الاستخدام             |
| ----------- | ----------------------- | --------------------- |
| /help | يرسل أمر المساعدة | /help [الفئة] |
| /stop | يوقف السيرفر | /stop [true/false] |

كتل الكود

أداة تنسيق Markdown مفيدة جدًا أخرى هي كتل الكود. هذه مفيدة بشكل خاص للأدلة التي تتضمن استخدام الأوامر، السكربتات، مخرجات الطرفية والمزيد.

لاستخدام كتلة كود، استخدم ``` خارج النص الذي تريد وضعه في كتلة. يمكنك أيضًا تحديد اللغة بجانب أول ثلاث علامات backticks لتنسيق لغة البرمجة بشكل صحيح. المثال التالي يوضح استخدام كتلة كود بلغة JavaScript:

function hello(name) {
console.log(name)
}

var server = "ZAP-Hosting"
hello(server)

استخدام التنبيهات (Admonitions)

تُستخدم التنبيهات لتسليط الضوء على معلومات مهمة داخل دليلك. هناك خمسة أنواع متاحة، كل منها يخدم غرضًا مختلفًا.

عند استخدام التنبيهات، يجب دائمًا تحديد عنوان واضح ووصفي. العنوان يضمن أن يفهم القراء على الفور سياق وأهمية المعلومات المميزة دون الحاجة لقراءة النص الكامل أولاً.

الصيغة العامة متطابقة لجميع الأنواع. يتغير فقط الكلمة المفتاحية حسب الغرض المقصود:

:::warning[العنوان]
محتواك هنا.
:::

ملاحظة

مثال: معلومات إضافية

استخدم هذا النوع للمعلومات التكميلية التي قد تساعد القارئ لكنها ليست ضرورية لإكمال الدليل.

نصيحة

مثال: نصيحة لتحسين الأداء

استخدم هذا النوع لمشاركة نصائح عملية، أفضل الممارسات، أو تحسينات الكفاءة بناءً على الخبرة.

معلومات

مثال: متطلب أو تفصيل مهم

استخدم هذا النوع للمعلومات السياقية المهمة التي يجب أن يكون القارئ على علم بها قبل أو أثناء العملية.

تحذير

مثال: خطر في التكوين

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

خطر

مثال: خطأ معروف أو ميزة مهجورة

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

لقطات الشاشة

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

يمكنك استخدام الصيغة التالية لإضافة لقطة شاشة إلى المحتوى، مع استبدال your_url برابط الصورة:

![](your_url)

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

المصطلحات

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

منتجات ZAP-Hosting

عند الإشارة إلى منتج من ZAP-Hosting، يجب عليك دائمًا التأكد من استخدام الاسم الصحيح، التهجئة، وحالة الأحرف. يمكنك التحقق من ذلك بزيارة موقع ZAP-Hosting ومراجعة كيفية الإشارة إلى المنتج في الموقع الخاص به.

السمات المعرفة من قبل المستخدم

في معظم الأدلة، ستكون خيارات التكوين لعناصر مثل المستخدمين، أسماء المضيفين، النطاقات، عناوين IP وعناوين URL مطلوبة، حيث يجب على القارئ استخدام بياناته الخاصة بدلًا من العناصر النائبة لدينا.

بشكل افتراضي، يجب عليك دائمًا استخدام [your_attribute] للتمييز بين العناصر الثابتة والفريدة، حيث يجب استبدال attribute بنوع السمة. على سبيل المثال، عند ذكر IP، يجب أن تكتب [your_server_ip] في دليلك أو عند ذكر URL يجب أن تكتب http://[your_server_ip]:30120.

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

يجب استخدام zaphosting كاسم المضيف الافتراضي، اسم المستخدم أو اسم قاعدة البيانات.

البرمجيات

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

يجب ربط اسم البرمجية بموقعها الرسمي عند ذكرها لأول مرة، وحيثما يتوفر موقع رسمي.