Skip to content

Rapikan suara dokumentasi dan copy publik - #49

Merged
man612 merged 24 commits into
mainfrom
chore/editorial-voice-cleanup
Sep 3, 2026
Merged

Rapikan suara dokumentasi dan copy publik#49
man612 merged 24 commits into
mainfrom
chore/editorial-voice-cleanup

Conversation

@man612

@man612 man612 commented Sep 3, 2026

Copy link
Copy Markdown
Owner

Ringkasan

Merapikan suara dokumentasi dan copy publik agar lebih natural, ringkas, dan konsisten dengan Ramu sebagai proyek solo-builder yang tumbuh dari kebutuhan nyata.

Perubahan ini bersifat editorial. Manifest, source registry JSON, schema, Project Instructions, protocols, course pack runtime, dan behavior/eval contracts tetap tidak berubah. Satu perubahan kecil pada scripts/validate_site.py hanya menyinkronkan marker copy Study Mode setelah wording site diperbarui; semantic gate-nya tetap sama.

Yang dibenahi

  • README dipadatkan dan diberi konteks asal-usul proyek yang lebih personal tanpa menjadikannya narasi pribadi berlebihan.
  • Copy website dan setup dibuat lebih langsung serta mengurangi pola berulang seperti “Ramu tidak…”, “Ramu sengaja…”, dan istilah teknis yang tidak perlu muncul di permukaan pengguna.
  • Docs aktif (ARAH-PROYEK, setup, source/validation, research/design, release process, pilot, eval/manual, learning, support/security/contributing) diselaraskan ke gaya yang sama.
  • Pack README Semester 2 dan Semester 3 dibuat lebih praktis tanpa mengubah fakta akademik.
  • Dokumentasi stale setelah Semester 3 diperbaiki, termasuk referensi “Semester 3 nanti” dan FAQ site yang masih menyebut hanya Semester 2.
  • Hero README dibuat pack-neutral dan contoh S2 • AKM I diganti Semester 2 • AKM I supaya tidak ambigu dengan jenjang pendidikan.
  • Site validator tetap memeriksa status Study Mode, tetapi marker literal lama Ramu tidak bergantung pada Study Mode diganti dengan fakta produk yang sekarang dipakai copy: Study Mode tidak berlaku pada Project conversations.

Batas perubahan

  • Historical release notes dan bagian changelog lama tetap dipertahankan sebagai snapshot.
  • Wording runtime/behavior tidak dipoles dalam PR ini karena dapat mengubah semantics pengujian atau perilaku Project.
  • Metadata description repository GitHub belum diubah karena action write untuk metadata repository tidak tersedia pada connector yang dipakai.

Verifikasi

  • static/schema/identity validation tetap harus hijau;
  • site validation tetap menjaga kontrak struktural dan current product marker;
  • eval-wiring Semester 2 dan Semester 3 tetap identik secara behavior;
  • tidak ada manifest/source/runtime/behavior contract yang berubah;
  • CodeQL tetap harus hijau.

Risiko

Perubahan paling besar ada pada prose dan copy user-facing. Struktur HTML, JS hooks, pack catalog, dan runtime contracts sengaja dipertahankan.

@man612
man612 merged commit 6338bf8 into main Sep 3, 2026
8 checks passed
@man612
man612 deleted the chore/editorial-voice-cleanup branch September 3, 2026 08:59
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant