منصة توثيق مركزية للفرق التقنية
قم بتسجيل سير العمل الفني، وإجراءات النشر، وكتيبات تشغيل الحوادث، والمسارات الإرشادية للأدوات الداخلية. تُنتج منصة Trupeer AI مقاطع فيديو بالإضافة إلى وثائق مكتوبة يمكن إضافتها بسهولة إلى Confluence أو Notion أو ويكيبيديا GitHub أو أي منصة وثائق مركزية قائمة.
إنشاء مستندات تقنية مجاناً
لا تحتاج معظم الفرق الهندسية بالفعل إلى منصة توثيق مركزية جديدة. لديهم واحدة بالفعل (Confluence، أو Notion، أو GitHub wiki، أو بوابة مطورين داخلية). ما يحتاجون إليه هو طريقة لملئها بالتوثيق الفني الذي يظل محدثًا. تسجل أداة التوثيق الفني من Trupeer AI سير العمل مرة واحدة وتنتج جولة فيديو مصقولة بالإضافة إلى دليل فني مكتوب، وتكون جاهزة للتضمين في أي نظام تستخدمه المجموعة بالفعل كطبقة توثيق مركزية لها. إن عنق الزجاجة في معظم المستندات الفنية هو الإنتاج، وليس التخزين.
سجل سير العمل الفني مرة واحدة. احصل على فيديو مصقول ودليل فني مكتوب في نفس المهمة.
قم بتضمين الناتج في أي منصة توثيق مركزية موجودة: Confluence، أو Notion، أو GitHub wiki، أو بوابة مطورين داخلية.
قم بالتحديث من خلال إعادة تسجيل الخطوة التي تغيرت. ويبقى باقي التوثيق الفني كما هو دون تغيير.
ترجم التوثيق الفني لأكثر من 65 لغة لفرق الهندسة العالمية.
شارك عبر رابط صفحة مشتركة تحمل هويتك التجارية يمكن للفريق نشرها في Slack، أو تضمينها في أي wiki، أو تسليمها للدعم.
ما الذي ينتجه Trupeer AI للتوثيق الفني
يسجل المهندس جولة على الشاشة لعملية نشر، أو جلسة تصحيح أخطاء، أو إجراء استجابة للحوادث، أو أي سير عمل فني آخر. يتولى Trupeer AI معالجة ما بعد الإنتاج. تتم إزالة الكلمات المتكررة ولحظات التردد مثل "امم، دعني أجد علامة التبويب الصحيحة". ويتم تنعيم اهتزاز المؤشر وانتقالات التكبير. وتصل مسودة فيديو ومسودة دليل فني مكتوب في نفس المهمة، بحيث لا يضطر الفريق إلى الاحتفاظ بمصدرين منفصلين للمعلومات لنفس الإجراء.
مخرجات الفيديو هي بصيغة MP4، جاهزة للتضمين في أي برنامج توثيق فني. ومخرجات المستندات هي بصيغة PDF أو Word، جاهزة لـ wiki الهندسي أو لتسليمها للمراجع. يتم تطبيق هوية العلامة التجارية تلقائيًا: شعار الشركة، والألوان، والخطوط، وشرائح المقدمة والخاتمة كلها تتطابق مع باقي مكتبة التوثيق الهندسي. ويتعامل القاموس المخصص مع أسماء المنتجات الداخلية، وأسماء الأدوات، وأسماء واجهات برمجة التطبيقات (API) التي لن يعرف الذكاء الاصطناعي كيفية تهجئتها أو نطقها بطريقة أخرى، وهو أمر يهم المحتوى الفني أكثر من أي نوع توثيق آخر. وتتولى طبقة تسجيل الشاشة بالذكاء الاصطناعي تمييز المؤشر، والتركيز على المنطقة، والتكبير التلقائي للتفاعلات في واجهة المستخدم، وهو ما تتجاهله معظم أدوات الكتابة الفنية أو تفعله بشكل سيء.
كيف تعمل أداة التثويق الفني بثلاث خطوات
يستغرق التدفق الكامل تسجيلاً واحدًا وينتج توثيقًا فنيًا جاهزًا للنشر و ذو جودة عالية. لا حاجة لنص تحضيري، ولا حاجة لمراجعة منفصلة للكتابة الفنية، ولا تراكم للوثائق لتصفيته على مدار الربعين القادمين.
الخطوة 1: تسجيل سير العمل الفني
اضغط على زر التسجيل في المتصفح، والتقط سير العمل كما يتم إجراؤه بالفعل، أو ارفع تسجيلاً حاليًا للشاشة. يعمل الذكاء الاصطناعي على ما تم تسجيله. إن تسجيل عملية نشر مدتها 12 دقيقة أسرع من كتابة كتيب تشغيل مكون من 4 صفحات من الذاكرة، والنتيجة أكثر دقة لأن التوثيق يعكس ما فعله المهندس بالفعل، وليس ما يتذكر أنه فعله.
الخطوة 2: يقوم Trupeer AI بإنشاء الفيديو والدليل الفني المكتوب
تتم إزالة الحشو اللغوي. وتتم إضافة تأثيرات التكبير والمؤشر حيثما تساعد المشاهد على متابعة ما يحدث على الشاشة. تظهر مسودة الفيديو ومسودة الدليل الفني في المحرر معًا. ويتم تطبيق القاموس المخصص، بحيث تتم تهجئة أسماء الأدوات الداخلية، ونقاط نهاية واجهة برمجة التطبيقات (API endpoints)، وأسماء المنتجات ونطقها بشكل صحيح في كلا المخرجين.
الخطوة 3: تطبيق الهوية التجارية والترجمة والنشر في طبقة المركزية الحالية
قم بتطبيق هوية العلامة التجارية بحيث يتطابق شعار الشركة وألوانها وشرائح المقدمة والخاتمة مع باقي مكتبة التوثيق الهندسي. ترجم إلى اللغات التي يتحدث بها الفريق الهندسي العالمي (الإسبانية، أو الماندرين، أو الهندية، أو البرتغالية، أو أي من أكثر من 65 خيارًا). ثم انشر عبر رابط الصفحة المشتركة الذي يمكن للفريق تضمينه في Confluence، أو Notion، أو GitHub wiki، أو بوابة المطورين الداخلية، أو أي نظام توثيق مركزي آخر يستخدمه الفريق بالفعل.
من يفتح Trupeer AI فعليًا للتوثيق الفني
الشخص الذي يفتح هذه الأداة هو عادة قائد تقني، أو مدير هندسي، أو قائد DevOps في شركة تم فيها إدراج "التوثيق" كأحد الأهداف والنتائج الرئيسية (OKR) لربعين متتاليين على الأقل. وبشكل مستمر، يعرف الفريق الهندسي ما يجب توثيقه. ولكن ما يفتقرون إليه هو وجود أي شخص على استعداد لقضاء أسبوع في كتابة ما يمكنهم تسجيله في 30 دقيقة. يسد Trupeer AI الفجوة بين معرفة ما يجب توثيقه وإنتاج التوثيق بالفعل.
يظهر نفس سير العمل عبر الأدوار المختلفة. تستخدمه فرق SRE و DevOps لكتيبات تشغيل الاستجابة للحوادث، وإجراءات النشر، وجولات البنية التحتية. وتستخدمه فرق هندسة المنصات لتوثيق الأدوات الداخلية التي تشرح كيفية عمل الأنظمة المصممة محليًا للفريق بالفعل. يستخدمه المديرون الهندسيون لنشر وثائق تهيئة الموظفين الجدد، والتي تغطي إعداد البيئة، واتفاقيات قاعدة التعليمات البرمجية، والأدوات الخاصة بالفريق. وتستخدمه فرق تجربة المطورين لإنشاء توثيق فني لواجهات برمجة التطبيقات الداخلية والمكتبات المشتركة التي تعتمد عليها بقية الشركة. تتعامل بعض الفرق مع الأداة كبديل لتوظيف كاتب توثيق فني؛ بينما تستخدمه فرق أخرى إلى جانبه لمضاعفة إنتاج ذلك الشخص.
حالات استخدام التوثيق الفني التي يتعامل معها Trupeer AI
يغطي التوثيق الفني عادةً أربعة أنواع من المحتوى: كيف يعمل شيء ما، وكيفية القيام بشيء ما، وماذا حدث عندما تعطل شيء ما، وأين تكمن الحدود بين الأنظمة. يتعامل Trupeer AI مع الأربعة جميعًا من خلال نفس تدفق عملية التسجيل إلى المستند. جولات النشر، وأدلة إعداد البيئة، وتحليلات ما بعد الحوادث، ونظرات عامة على المعمارية، كلها تبدأ كتسجيل للشاشة وتنتهي كفيديو مصقول بالإضافة إلى دليل فني مكتوب. التنسيق الذي كان يتطلب سابقًا نموذج كتابة فنية، أو نموذجًا تم تنزيله للتوثيق الفني، أو أحد نماذج الكتابة الفنية القياسية من بحث Google، أو ملف Word مخصص لنموذج توثيق فني عام، يصبح أي شيء يريد المهندس إنتاجه، ومنظمًا تلقائيًا بواسطة الذكاء الاصطناعي. الفرق التي قامت سابقًا بتقييم برمجيات كتابة فنية منفصلة لمجرد الحصول على نموذج قابل للاستخدام تتخلى عادةً عن تلك الطبقة بمجرد تطبيق Trupeer.
بالنسبة للتوثيق الفني للبرمجيات، فإن حالة الاستخدام الأكثر ربحية وفائدة سريعة هي جولة الأدوات الداخلية. لدى كل فريق هندسي على الأقل بضع أدوات تم تطويرها داخليًا ولا يعرف أحد خارج الفريق كيفية استخدامها. إن تسجيل الاستخدام الفعلي لتلك الأدوات وإنشاء توثيق مرئي ومكتوب في مهمة واحدة يعني أن المهندس التالي الذي يحتاج إلى استخدام الأداة لن يضطر إلى مراسلة الفريق الذي بناها عبر Slack. وينطبق نفس النمط على توثيق التصميم الفني: بدلاً من كتابة التصميم بعد حدوثه، سجل اجتماع مراجعة التصميم ودع Trupeer AI ينشئ المستند الفني المنظم منه. وتعمل كتابة التقارير الفنية لما بعد الحوادث وتحليلات الأسباب الجذرية بنفس الطريقة: سجل جلسة التحليل، أنشئ المستند، وانشره.
يكتسب الذكاء الاصطناعي في الكتابة الفنية مكانته عندما يدرك الفريق أنه يمكنهم تحديث التوثيق الفني الحالي من خلال إعادة التسجيل، بدلاً من التعامل مع كل تحديث كإعادة كتابة كاملة. وينطبق نفس المنطق على كتابة المحتوى الفني بشكل أوسع. تتوقف الفرق الهندسية عن تجنب التوثيق عندما تنخفض تكلفة إنتاجه عن تكلفة شرح نفس الشيء في Slack أربع مرات في الربع الواحد. هذا التحول هو التغيير الهيكلي الفعلي الذي من المفترض أن تتيحه منصة التوثيق المركزية للفرق الفنية، وهو الفجوة التي تتركها معظم المنصات للفريق ليحلها بمفرده. Trupeer AI هو ما تلجأ إليه معظم الفرق كنموذج للتوثيق الفني لبرمجياتهم، لأن المخرجات ملموسة بما يكفي لاستخدامها كمرجع لما تبدو عليه الكتابة الفنية والتوثيق الجيد بالفعل.
أين يقع Trupeer AI بجانب Confluence و Notion و GitHub wiki وأدوات المركزية الأخرى
لا يحل Trupeer AI محل طبقة المركزية. يظل الـ wiki كما هو wiki. ويظل Confluence كالمكان الذي يعيش فيه توثيق كل فريق. ويظل Notion كقاعدة المعرفة الداخلية للفريق الهندسي. ويظل GitHub wiki كموطن التوثيق المجاور للمستودع. وتظل بوابة المطورين الداخلية بمثابة المصدر المعتمد للمعلومات. يقع Trupeer AI خطوة واحدة قبل ذلك في سير العمل، حيث يتم إنتاج محتوى التوثيق فعليًا، وينشر المخرجات كرابط صفحة مشتركة يتم تضمينها في أي من طبقات المركزية الحالية دون تغيير الإعداد الحالي للفريق.
لقد استثمرت معظم الفرق الهندسية بالفعل في أداة المركزية التي تختارها. هم لا يريدون الهجرة إلى نظام آخر، بل يريدون أن تحتوي الأداة الحالية بالفعل على توثيق محدث. رابط الصفحة المشتركة لـ Trupeer AI هو الآلية التي تسد هذه الفجوة: يتم تحديث كل من الفيديو والمستند عند تحديث التسجيل الأساسي، مما يعني أن أي شخص لديه الرابط المضمن في ويكيبيديا فريقه يرى النسخة الحالية تلقائيًا. يظل الـ wiki بمثابة طبقة التخزين والاكتشاف. ويتولى Trupeer AI الإنتاج في المراحل الأولى والصيانة المستمرة، وهو ما تتركه معظم منصات المركزية للفرق لتكتشفه بمفردها.
التحديثات: أعد تسجيل الخطوة التي تغيرت، وحافظ على بقية التوثيق الفني سليمًا
يتقادم التوثيق الفني بشكل أسرع من أي نوع آخر لأن الأنظمة الأساسية تتغير أسبوعيًا. تتغير عملية النشر عندما ينتقل الفريق إلى منصة CI/CD جديدة. ويتغير كتيب تشغيل الحوادث عندما يتغير مورد قاعدة البيانات. وتتغير أدلة التهيئة عندما يتبنى الفريق بيئة تطوير متكاملة (IDE) جديدة أو ينتقل إلى أداة مراجعة أكواد مختلفة. تجبر معظم أدوات التوثيق الفريق على إعادة كتابة الأقسام المتأثرة من الصفر في كل مرة. يتعامل Trupeer AI مع التحديثات من خلال إعادة تسجيل الخطوة التي تغيرت فقط.
إعادة التسجيل أسرع من إعادة الكتابة. يقوم المهندس الذي سجل سير العمل في الأصل بتسجيل النسخة الجديدة من الخطوة التي تغيرت. يقوم الذكاء الاصطناعي بإعادة معالجة هذا الجزء فقط. يتم تحديث كل من الفيديو والدليل الفني المكتوب في مكانهما. يشير أي رابط صفحة مشتركة وزعه الفريق في الربع الماضي الآن إلى النسخة الحالية، مع دمج الخطوة المحدثة في بقية التوثيق. يحصل أي شخص قام بحفظ الرابط الأصلي في المفضلة أو تضمينه في ويكيبيديا الفريق على المحتوى الجديد دون أي ملاحقة يدوية. نموذج التحديث هذا هو ما يجعل التوثيق الفني يظل قابلاً للاستخدام فعليًا عبر الأشهر والسنوات التي تستمر فيها الأنظمة الأساسية في التغيير. يغطي ربط أداة الإنشاء مع مُنشئ إجراءات التشغيل القياسية (SOP builder) من Trupeer AI إجراءات التشغيل القياسية التي تقع تحت سير العمل الفني المسجل.
لماذا تستخدم فرق الهندسة Trupeer AI لكتابة التوثيق الفني
سرعة إنتاج سيقبل بها المهندسون فعلياً
إن تسجيل 12 دقيقة من أعمال النشر أسرع من كتابة دليل تشغيل مكون من 4 صفحات. كما أنه أكثر دقة، لأنه يوثق ما قام به المهندس بالفعل.
تضمينات في الويكي الذي تستخدمه بالفعل
تضمين روابط الصفحات المشتركة في Confluence أو Notion أو GitHub wiki أو أي بوابة مطورين. بدون ترحيل، وبدون منصة جديدة.
تحديثات بدون إعادة كتابة
عندما يتغير النظام، أعد تسجيل الخطوة المتأثرة. يتم تحديث كل من الفيديو والمستند تلقائيًا في مقامهما، وتظل عمليات التضمين محدثة.
اشحن المستندات الفنية في ثلاث خطوات
الخطوة 1
سجل سير العمل الفني على الشاشة أو قم بتحميل لقطات حالية
الخطوة 2
تقوم تقنية Trupeer AI بإنشاء الفيديو والدليل الفني المكتوب معًا
الخطوة 3
إضافة العلامة التجارية، والترجمة، والدمج في أي موقع ويكي أو بوابة مطورين
الأسئلة الشائعة
هل أداة التوثيق الفني مجانية للاستخدام؟
نعم بالنسبة للمسار الأساسي. قم بتسجيل سير العمل الفني، وإنشاء الفيديو والتوثيق المكتوب، والمشاركة عبر رابط صفحة مشتركة دون دفع. تضيف الفئات المدفوعة مجموعات العلامات التجارية، والصور الرمزية للذكاء الاصطناعي، واستنساخ الصوت المخصص، ومساحات عمل الفريق، والترجمة عبر أكثر من 65 لغة، وحدود تسجيل أطول. تفاصيل الأسعار على صفحة الأسعار.
ما هي الوثائق الفنية، وما الذي يقدمه تطبيق Trupeer AI؟
u062au063au0637u064a u0627u0644u0645u0633u062au0646u062fu0627u062a u0627u0644u0641u0646u064au0629 u0623u064a u0645u062du062au0648u0649 u064au0648u0636u062d u0643u064au0641u064au0629 u0639u0645u0644 u0627u0644u0646u0638u0627u0645 u0627u0644u0641u0646u064a u0623u0648 u0643u064au0641u064au0629 u0623u062fu0627u0621 u0645u0647u0645u0629 u0641u0646u064au0629: u0623u062fu0644u0629 u062au0634u063au064au0644 u0627u0644u0646u0634u0631u060c u0648u0625u062cu0631u0627u0621u0627u062a u0627u0644u0627u0633u062au062cu0627u0628u0629 u0644u0644u062du0648u0627u062fu062bu060c u0648u0623u062fu0644u0629 u0625u0639u062fu0627u062f u0627u0644u0628u064au0626u0629u060c u0648u062cu0648u0644u0627u062a u0627u0644u0623u062fu0648u0627u062a u0627u0644u062fu0627u062eu0644u064au0629u060c u0648u0646u0638u0631u0627u062a u0639u0627u0645u0629 u0639u0644u0649 u0628u0646u064au0629 u0627u0644u0646u0638u0627u0645u060c u0648u0633u064au0627u0642u0627u062a u0639u0645u0644 u0627u0633u062au0643u0634u0627u0641 u0627u0644u0623u062eu0637u0627u0621 u0648u0625u0635u0644u0627u062du0647u0627. u064au0642u0648u0645 Trupeer AI u0628u062au0648u0644u064au062f u062au0648u062bu064au0642 u0643u064au0641u064au0629 u0633u064au0631 u0627u0644u0639u0645u0644 u0627u0644u0641u0646u064a u0641u0639u0644u064au0627u0641 u0639u0644u0649 u0634u0643u0644 u0641u064au062fu064au0648 u0645u062du0633u0646 u0628u0627u0644u0625u0636u0627u0641u0629 u0625u0644u0649 u062fu0644u064au0644 u0641u0646u064a u0645u0643u062au0648u0628 u064au062du062au0648u064a u0639u0644u0649 u0644u0642u0637u0627u062a u0634u0627u0634u0629 u0648u062eu0637u0648u0627u062a u0645u0631u0642u0645u0629. u064au062au0645 u062au0646u0632u064au0644 u0627u0644u0645u062eu0631u062cu0627u062a u0641u064a u0623u064a u0645u0646u0635u0629 u062au0648u062bu064au0642 u0645u0631u0643u0632u064au0629 u064au0633u062au062eu062fu0645u0647u0627 u0627u0644u0641u0631u064au0642 u0628u0627u0644u0641u0639u0644.
ما هي المدخلات والمخرجات التي تدعمها أداة التوثيق الفني؟
المدخلات: تسجيلات الشاشة، وتنزيلات كاميرا الويب، وملفات الفيديو المرفوعة، والملفات الصوتية، والنصوص المكتوبة. المخرجات: فيديو بصيغة MP4 ووثائق تقنية بصيغة PDF أو Word (DOCX). يتم تقديم كلا المخرجين أيضاً كصفحة مشتركة (Shared Page)، وهي عبارة عن رابط يحمل العلامة التجارية للمؤسسة يمكن تضمينه في أي مكان يشارك فيه الفريق المحتوى بالفعل. كما تنطبق الترجمة إلى أكثر من 65 لغة على كل من الفيديو والوثيقة في نفس المهمة.
هل يتكامل Trupeer AI مع الويكي الحالي أو بوابة المطورين لدينا؟
يُنشئ Trupeer AI رابط صفحة مشتركة يمكن تضمينه في أي ويكي، أو قاعدة معرفية، أو بوابة مطورين، أو موقع توثيق يقبل مقاطع الفيديو أو المستندات المضمنة. تظل منصة التوثيق المركزية الحالية للفريق (سواء كانت Confluence، أو Notion، أو ويكي GitHub، أو البوابة الداخلية، أو غير ذلك) كما هي دون تغيير. ويتولى Trupeer AI جانب إنتاج المحتوى لتدفق العمل، وليس جانب التخزين أو الاستكشاف.
ماذا يحدث عندما يتغير النظام أو سير العمل الأساسي؟
أعد تسجيل الخطوة التي تغيرت فقط. سيعيد Trupeer AI معالجة هذا الجزء، ويتم تحديث كل من الفيديو والوثائق المكتوبة على الفور. أي شخص لديه رابط الصفحة المشتركة يرى الإصدار الجديد تلقائيًا. لا يتعين على الفريق تعقب كل مكان تم فيه تضمين الرابط القديم، أو إعادة بناء الوثائق من الصفر، أو التنسيق مع كل من قام بحفظ الرابط الأصلي. نموذج التحديث هذا هو ما يجعل الوثائق التقنية قابلة للاستخدام فعليًا عندما تتغير الأنظمة الأساسية بالسرعة التي تتغير بها في معظم الفرق الهندسية.
