অবদান রাখা

এই public repository-তে ternux website ও public documentation আছে। Compatibility evidence, correction, translation এবং reproducible workload observation সবচেয়ে উপকারী contribution।

Proprietary installer code, private Pro procedure, licence material, customer data বা private endpoint এখানে submit করবেন না।

Issue খোলার আগে

• Existing issue search করুন।
• Phone, Android version, SoC/GPU, RAM ও graphics route লিখুন।
• Paraphrase না করে exact relevant output দিন।
• Username, licence key, API token, Wi-Fi detail ও project secret সরান।
• কী আশা করেছিলেন এবং আসলে কী হয়েছে—দুটিই বলুন।

Graphics report-এ “GPU works” বলার চেয়ে renderer string বেশি উপকারী। Workload report-এ app version, scene/model size, memory pressure, session-এর আনুমানিক সময় ও thermal state দিন।

Evidence-এর ধরন

Claim সৎভাবে label করুন:

• Measured: নাম দেওয়া command বা repeatable test-এর ফল।
• Observed: “এই Blender sample smooth লেগেছে”—এমন first-hand result।
• Inferred: architecture বা related evidence থেকে সমর্থিত সিদ্ধান্ত।
• Planned: validation শেষ না হওয়া Pro design target।

এক device-এর observation-কে universal promise বানাবেন না। বিশেষ করে Blender, local-AI ও benchmark result driver, workload, RAM ও temperature অনুযায়ী অনেক বদলায়।

Public documentation-এর scope

যা স্বাগত:

• Device compatibility ও OEM limitation
• Renderer, audio ও session troubleshooting
• Safe daily operation ও backup advice
• Reproducible Blender বা local-AI finding
• Responsible development-agent guidance
• স্পষ্ট Android/PRoot limit সহ authorised defensive security-lab guidance
• English/Bangla parity ও accessibility improvement

Public repository-র বাইরে থাকবে:

• সম্পূর্ণ Pro installation procedure বা proprietary module
• Official release-এর আগে live licence/download endpoint
• Real credential, wallet address, customer support bundle বা private log
• Unauthorised intrusion instruction বা real-world target
• Third-party service স্থায়ী বা universally free—এমন দাবি

লেখার style

• সহজ ভাষা ও ছোট paragraph ব্যবহার করুন।
• Capability-এর সঙ্গে limitation-ও লিখুন।
• Tested result ও recommendation আলাদা রাখুন।
• Security example defensive ও permission-based রাখুন।
• Network exposure বিষয় না হলে service example loopback-এ রাখুন।
• সম্ভব হলে একই change-এ English ও Bangla page মিলিয়ে update করুন।
• Markdown prose প্রায় ৮০ column-এ wrap করুন।

Repository Markdown-এ internal link .md ব্যবহার করে; GitHub Pages সেটি .html-এ rewrite করে।

Change check করা

Submit করার আগে:

1. YAML front matter-এ matching lang ও alt_url দেখুন।
2. Code fence ও HTML tag balanced কিনা দেখুন।
3. Internal link ও heading anchor পরীক্ষা করুন।
4. Diff-এ secret ও personal data search করুন।
5. Public wording কোনো private Pro implementation detail প্রকাশ করছে না নিশ্চিত করুন।
6. HTML/CSS বদলালে desktop ও narrow mobile layout preview করুন।

Commit ও pull request

• এক commit-এ একটি পরিষ্কার intent রাখুন।
• Change কেন দরকার ব্যাখ্যা করুন।
• কী, কোন device-এ এবং কীভাবে test করেছেন লিখুন।
• Behaviour claim-এর before/after evidence দিন।
• Secret commit করবেন না। Public channel-এ paste হলে token revoke করুন; message delete বা Git history rewrite যথেষ্ট নয়।

Security issue report

Vulnerability, leaked private endpoint বা credential-handling problem-এর জন্য GitHub Security Advisories ব্যবহার করুন। Private channel স্পষ্টভাবে না চাইলে active secret দেবেন না; আগে exposed credential revoke করুন।

Licence

Public documentation contribution MIT Licence-এর অধীনে accepted। এতে ternux Pro বা তার private material-এর access বা licence বদলায় না।

ternux — Copyright (c) 2026 Sobuj Miah (@soobujmiah) · MIT