Osallistuminen

Missä voi auttaa

• Bugiilmoitukset — erityisesti whitelist-ohitukset tai hakuindeksin ongelmat (palautesivu)
• Crawler-testaus — Playwright-indeksointi eri sivustoilla
• Servo-yhteensopivuus — Telakka-korjaukset (Kela, Suomi.fi, …)
• Dokumentaatio — parannukset Katselin.fi-repoon

Whitelist-ehdotukset

Kuratoidut sivulistat hallinnoidaan yksityisessä repossa. Uusien domainien ehdotukset: ota yhteyttä ylläpitäjään tai avaa keskustelu GitHubissa. Julkiseen selainrepoon ei lisätä tuotantodataa.

Oppiminen

Katselin on rakennettu Rustilla (Servo-fork). Jos kieli tai selainmoottori on uusi, nämä suomenkieliset kirjat auttavat alkuun ennen kuin sukellat selainrepoon.

Rust-perusteet

Rust-ohjelmointikieli

Suomenkielinen versio virallisesta Rust-kirjasta (Steve Klabnik, Carol Nichols ja Rust-yhteisö). Englanninkielinen alkuperäinen: doc.rust-lang.org/book. Asennuksen jälkeen sama kirja löytyy myös komennolla rustup doc --book.

Servo ja Katselin

Servo-kirja

Suomenkielinen versio Servon kehittäjäkirjasta: servoshellin kääntäminen ja ajaminen, arkkitehtuuri, osallistuminen ja kirjastojen käyttö. Englanninkielinen alkuperäinen: book.servo.org.

Rust-muutokset

Kaikki Katselin-spesifinen Rust-koodi kuuluu components/kotisatama/ -hakemistoon. Älä muokkaa Servo-upstream-tiedostoja ilman pakottavaa syytä.

Whitelist toteutetaan embedder-hookissa (ports/servoshell), ei components/net/-tasolla.

Tarkistuslista ennen PR:ää:

cargo build                          # ilman featurea
cargo build --features kotisatama    # featurella

Tarkemmat säännöt selainrepon AGENT.md-tiedostossa.

Kehitysympäristö

1. Asenna Servon kehitysympäristö.
2. Kloonaa ja rakenna:

git clone https://github.com/Mikko-Huuskonen-Pro/Kotisatama.git
cd Kotisatama
./mach build --release
./mach run

Paikallinen whitelist kehityksessä:

cp config/whitelist.example.json config/whitelist.json
export KOTISATAMA_WHITELIST_PATH=config/whitelist.json

Bugiilmoitukset

Käytä palautesivua tai avaa GitHub Issue. Kerro mitä teit, mitä odotit, mitä tapahtui ja käyttöjärjestelmä.

Tietoturva-aukoista: tietoturvaohje — ei julkisena issuena.

Servo-upstream

Servo-projektin omiin muutoksiin osallistuminen tapahtuu servo/servo-repon kautta.