Improve GitHub presentation and CI

Author: ferhannb

.github/workflows/build.yml

@@ -0,0 +1,24 @@
+name: Build
+
+on:
+  push:
+  pull_request:
+
+jobs:
+  ubuntu-build:
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Install dependencies
+        run: |
+          sudo apt-get update
+          sudo apt-get install -y build-essential cmake qtbase5-dev libqt5svg5-dev
+
+      - name: Configure
+        run: cmake -S . -B build -DCMAKE_BUILD_TYPE=Release
+
+      - name: Build
+        run: cmake --build build

CONTRIBUTING.md

@@ -0,0 +1,62 @@
+# Contributing
+
+## Scope
+
+This repository is currently a research and prototyping codebase for marine route planning. Contributions that improve reproducibility, build reliability, algorithm clarity, and dataset handling are the most useful.
+
+## Development Setup
+
+On Ubuntu:
+
+```bash
+sudo apt-get update
+sudo apt-get install -y build-essential cmake qtbase5-dev libqt5svg5-dev
+cmake -S . -B build -DCMAKE_BUILD_TYPE=Debug
+cmake --build build -j
+```
+
+Optional data preparation:
+
+```bash
+./scripts/download_coastline_data.sh
+```
+
+## Contribution Guidelines
+
+- Keep changes focused and easy to review.
+- Prefer small pull requests over large mixed changes.
+- Do not commit generated caches, local virtual environments, or large temporary datasets.
+- Update `README.md` when user-facing commands, data expectations, or outputs change.
+- Add or update validation steps when changing planner behavior.
+
+## Good Contribution Areas
+
+- CI and cross-platform build improvements
+- automated smoke tests
+- dataset packaging and size reduction
+- benchmark scenarios and reproducibility
+- route quality validation and regression checks
+- documentation, examples, and demo assets
+
+## Pull Requests
+
+When opening a pull request, include:
+
+- what changed,
+- why it changed,
+- how you validated it,
+- any dataset or environment assumptions.
+
+If your change affects outputs, include at least one screenshot, SVG, or command example.
+
+## Issues
+
+Please use issues for:
+
+- build failures,
+- incorrect routing behavior,
+- dataset import problems,
+- reproducibility gaps,
+- documentation problems.
+
+Clear reproduction steps are more useful than long descriptions.

LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Ferhan B
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.