توثيق واضح لمطوّريك وعملائك وفرقك التقنية.

ابدأ بالمحتوى الذي يحتاجه عملاؤك للانطلاق بسرعة:

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

وإذا كان منتجك يوفّر واجهة API عامة، فأضف مرجع API ودليل بدء سريع للمطورين.

نساعدك على تحديد ما هو ضروري للإطلاق، ثم نوسّع التوثيق معك مع نمو منتجك.

نعم. لن تحتاج إلى التنسيق بشكل منفصل مع كاتب ومصمم ومحرر فيديو ومطوّر لموقع التوثيق؛ فنحن نجمع لك الكتابة والتصميم وتطوير الموقع والصيانة المستمرة في عقد واحد.

وحسب نطاق مشروعك، يمكننا أن نقدّم لك:

• مخططات تقنية: مخططات لبنية الأنظمة، ومخططات انسيابية، وخرائط عمليات تبسّط على فريقك وعملائك فهم الأنظمة المعقدة.
• عناصر مرئية للتوثيق: رسومات مخصصة، ولقطات شاشة توضيحية، وصور متحركة (GIF) ترشد مستخدميك إلى الخطوة التالية.
• فيديوهات شرح: جولات وعروض لمنتجك بتعليق صوتي بالذكاء الاصطناعي.
• نظام تصميم على Figma: مكونات قابلة لإعادة الاستخدام وإرشادات بصرية تحافظ على اتساق توثيقك.
• مواقع التوثيق: تصميم مركز المساعدة أو بوابة المطورين وتطويرها ونشرها.
• ربط روبوتات المحادثة بالذكاء الاصطناعي: نربط توثيقك بروبوت محادثة يساعد عملاءك على إيجاد الإجابات فورًا.
• تحسين SEO و AEO: نبني المحتوى بهيكل يسهّل ظهوره في Google ومحركات الإجابة بالذكاء الاصطناعي.
• الصيانة المستمرة: نبقي توثيقك متوافقًا مع كل إصدار وميزة وتغيير جديد.

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

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

كما ندعم الواجهات التي تُعرض من اليمين إلى اليسار (RTL)، ليتنقّل عملاؤك في المحتوى العربي بسهولة، مع توحيد المصطلحات والهيكل في اللغتين.

نعمل داخل أدواتك وسير عملك الحالي، بمراحل واضحة وتحديثات منتظمة:

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

أنت تقدّم خبرة المنتج والاعتماد النهائي، ونحن نتولى أعمال التوثيق من التخطيط حتى الصيانة.

لنبدأ، نحتاج منك عادةً إلى:

• صلاحية الوصول إلى المنتج: تكفي بيئة تجريبية (Staging) أو حساب تجريبي.
• المواد الحالية: أي توثيق أو مواصفات أو جولات مسجّلة للمنتج.
• موارد API عند الحاجة: مواصفات OpenAPI أو مجموعات Postman.
• إرشادات الهوية: نبرة الخطاب والمصطلحات ومراجع التصميم.
• مسؤول مراجعة: شخص من فريقك يجيب عن أسئلة المنتج ويعتمد المسودات.

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

تعتمد المدة على مدى تعقيد واجهة API لديك، والمواد المتوفرة، ومتطلبات التصميم، وسرعة المراجعة من فريقك. التقديرات المعتادة:

• بوابة أساسية: من أسبوع إلى أسبوعين. إعداد مركّز يشمل أدلة تمهيدية، وتوثيقًا لما يصل إلى 20 نقطة نهاية (Endpoint)، وصفحة رئيسية.
• بوابة متوسطة: من 4 إلى 6 أسابيع. مرجع API أشمل، وأدلة للمطورين، وتصميم للبوابة.
• بوابة للمؤسسات: من شهرين إلى ثلاثة أشهر. توثيق موسّع، وواجهة مخصصة، وتكاملات متعددة، ومتطلبات أكثر تعقيدًا.

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

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

ونعمل مع فريقي المنتج والامتثال لديك للتحقق من المصطلحات المالية وتفاصيل المنتج. ويلتزم توثيقنا بالمتطلبات التي تعتمدها، لكنه لا يغني عن المراجعة الشرعية أو التنظيمية.

نجهّز توثيقك ونربطه بأدوات الدعم المعتمدة على الذكاء الاصطناعي، مثل Intercom Fin أو Freshdesk أو روبوت محادثة مخصص. ويشمل ذلك تنظيم المحتوى، وصياغة الإجابات بوضوح، وإعداد الربط عند الحاجة.

الهدف بسيط: أن يجد عملاؤك الإجابة المناسبة فورًا دون انتظار فريق الدعم. وتعتمد النتائج على جودة المحتوى، وإعداد روبوت المحادثة، وطبيعة أسئلة عملائك.

نهج docs-as-code يعني إدارة التوثيق بالطريقة نفسها التي تُدار بها البرمجيات: كتابة المحتوى بصيغة Markdown أو MDX، وتتبّع التغييرات عبر Git، والنشر من خلال سير عمل مؤتمت.

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

تعتمد المدة على مدى تعقيد منتجك، والمعلومات المتاحة، ومستوى التفصيل الذي تحتاجه. التقديرات المعتادة:

• تطبيق جوال أو ويب: أسبوع واحد. متطلبات الأعمال ومخططات سير العمل الداعمة.
• منتج SaaS أو B2B: من أسبوعين إلى ثلاثة أسابيع. مواصفات تفصيلية، وقصص مستخدمين (User Stories)، ومعايير قبول، ومخططات، ونماذج أولية (Wireframes).
• منتج للمؤسسات: 8 أسابيع أو أكثر. متطلبات أشمل، ومواصفات أنظمة، وإجراءات تشغيل، وتوثيق للعمليات.

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