Contributing

Find the source

The Console directory in the project repository contains the desktop application, translations, installation tools, paired public documentation and standalone website. Console has its own release version and uses a separately installed ASPL tool. Checkout changes do not change the contents or support claims of an already published archive.

For installing or using Console, start with Install and requirements and First run. For failures, use Troubleshooting.

Build, test and prepare a release in the checkout

Use the checkout's build instructions and test instructions. They list native development dependencies and which checks need a desktop session. The Arabic README is a corresponding contributor entry point.

The release preparation guide and website build and export guide are repository material in English. Follow them for staging, inventory verification and generated guides. Preparing a checkout or local website does not publish a release.

Edit both documentation locales

Follow the content authoring guide, in English. Public prose lives in paired Arabic and English Markdown under projects/terminal/docs/. Keep matching topic routes and the same stable section IDs and sequence. Review equivalent technical meaning in both locales before refreshing revision-bound review records; heading parity alone does not establish translation accuracy.

Keep exact command aliases, paths and supplied example bytes. Label a repository document's actual language instead of treating it as translated public guidance. Add only approved public resources; keep private inputs and internal verification material out of public pages. The content compiler checks counterparts and local destinations. The website and offline guides consume these sources, so edit the canonical prose rather than generated output or a second README user manual.