كيف توثقين مسلسلكِ المفتوح للبحث والتشارك المجتمعي

لماذا توثقين أمورك المفتوحة

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

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

ما يتعين القيام به في الوثيقة: بناء صورة كاملة

الوثائق الشاملة تتضمن أبعاداً متعددة لرحلتك المفتوحة كلما قدمت التفاصيل كلما أصبحت وثائقك أكثر قيمة للآخرين ولنفسك

تفاصيل إنشاء اللجنة والتداول

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

يومية للوحات التشغيلية

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

التحديات والأخطاء والقرارات

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

مقاييس الأداء والاستقرار

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

اختيار أدوات التوثيق الصحيحة

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

المدونات والمواقع الشخصية

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

مستودعات مراقبة الصدور

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

صحائف وقاعدة بيانات

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

وثائق الفيديو والوثائق المتعددة الوسائط

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

أفضل الممارسات المتعلقة بالوثائق الفعالة

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

أكتب لسمعك

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

تنظيم المعلومات

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

تشمل الافتراضات التي تضاف القيمة

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

الحفاظ على الاتساق عبر المؤسسات

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

تحديث منتظم وواضح

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

المساهمة في البحوث المفتوحة بابتس

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

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

وتقدم عدة مبادرات مجتمعية جمع وتحليل بيانات نظام تبادل المعلومات المفتوح لأغراض البحث، كما أن الموقع الشبكي OpenAPS على شبكة الإنترنت ] يوفر مبادئ توجيهية للمساهمة ببيانات في مشاريع البحث.

الخصوصية والأخلاقيات والتقاسم المسؤول

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

تم تسمية بياناتك

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

فهم المخاطر

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

مبادئ توجيهية مجتمعية

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

بناء المجتمع المحلي من خلال الوثائق

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

اجيبي على الأسئلة واوضحي النقاط المقلقة واعترفي عندما يُشير شخص ما إلى خطأ

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

The Looped Group] community provides forums and resources for OpenAPS users to share their experiences. Many users also publish their documentation on the ]Medium platform under the OpenAPS tag, where it reaches a broad audience interested in diabetes technology.

من الوثائق إلى الابتكار

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

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

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

بدء العمل: أول مدخل وثائقك

إن لم تبدأ بعد بتوثيق رحلتك المفتوحة، فأفضل وقت للبدء الآن، لا تحتاج إلى نظام كامل أو أشهر من البيانات لتبدأ، إبدأ بما لديك و تبنيه من هناك.

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

ابدأ بأداة تشعر بالراحة إذا لم تكن مستعداً لإنشاء مستودع للمدونات أو (جيت هوب) استخدم وثيقة نصية أو صحيفة مُنتشرة

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

قياس أثر وثائقك

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

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

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