Rewrite README: add overview, usage examples, and install instructions

[Jvr2022]

Motivation

• Clarify project purpose and onboarding by expanding the README with a concise overview, prerequisites, build/run examples, and packaging instructions.
• Surface common workflows (opening .seb files, handling seb:///sebs:// links, and running with a JSON config) so users can run the app quickly.
• Improve contributor guidance and licensing visibility.

Description

• Add a centered header with the project logo and an Overview section summarizing goals and supported features.
• Reorganize the document into Prerequisites, Build, Run, Create Release Artifacts, and Installation and add concrete examples for ./build/bin/safe-exam-browser, opening local files, remote links, and --config.
• Add Contributing references to CONTRIBUTING.md, CODE_OF_CONDUCT.md, and SECURITY.md and clarify the license line to reference LICENSE.
• Adjust wording around artifact locations and explicitly note that this repository is an independent Linux implementation (not an official Safe Exam Browser release).

Testing

• Documentation-only change; no automated tests were added or modified for this PR.

---

Codex Task

Summary by CodeRabbit

• Documentation
  • Enhanced documentation with a clearer overview of supported features and behaviors
  • Added step-by-step command examples for running the application in various scenarios
  • Expanded installation instructions for Debian/Ubuntu and Arch Linux distributions
  • Added contribution guidelines and process documentation
  • Reorganized and clarified release and licensing information

[coderabbitai]

Caution

Review failed

The pull request is closed.

ℹ️ Recent review info

⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Pro

Run ID: bdcd8781-e2e5-442e-b8af-97dc5ee41307

📥 Commits

Reviewing files that changed from the base of the PR and between 3438782 and 6f72268.

📒 Files selected for processing (1)

• README.md

---

📝 Walkthrough

Walkthrough

The README.md file underwent comprehensive restructuring and expansion. The plain-text header was replaced with a centered logo and updated tagline. New sections were added for Overview, Run commands, and Contributing guidelines. Installation instructions were reorganized by distribution. Release and License sections were updated and reworded.

Changes

Cohort / File(s)	Summary
Documentation Update README.md	Restructured header with logo and tagline; added Overview, Run commands, Contributing, and reorganized Installation subsections; updated Create Release Artifacts, and License sections; clarified non-official implementation status.

Estimated code review effort

🎯 1 (Trivial) | ⏱️ ~3 minutes

Poem

🐰 A fluffy README now stands tall,
With logos bright and sections clear,
Installing, running—we've got it all,
The docs are organized, my dear!
From logo top to license bright,
This rabbit's hoppy with delight! 🌟

✨ Finishing Touches

🧪 Generate unit tests (beta)

• Create PR with unit tests
• Commit unit tests in branch codex/rework-readme-to-enhance-presentation

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands and usage tips.}

[Copilot]

Pull request overview

This PR rewrites the root README to improve onboarding for the Linux Safe Exam Browser implementation by adding a centered header/logo, a clearer overview, concrete build/run examples, and contributor/license references.

Changes:

• Added a centered header section with project logo and a new “Overview” section describing goals and supported workflows.
• Reorganized guidance into clearer sections (Prerequisites, Build, Run, Create Release Artifacts, Installation) with concrete CLI examples.
• Added Contributing links (CONTRIBUTING / CoC / SECURITY) and clarified license reference.

---

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

[Copilot]

The # Safe Exam Browser for Linux line is inside a block-level HTML <div>. In GitHub Flavored Markdown, Markdown isn’t parsed inside block HTML, so this will render as literal # ... text instead of an H1 heading. Consider using an HTML <h1> (and <p> for the tagline) or moving the Markdown heading outside the <div> while keeping the image centered.