Skip to content

6.x: Create MkDocs documentation site#181

Open
matejsemancik wants to merge 10 commits into
6.xfrom
feature/6.x-mkdocs
Open

6.x: Create MkDocs documentation site#181
matejsemancik wants to merge 10 commits into
6.xfrom
feature/6.x-mkdocs

Conversation

@matejsemancik

@matejsemancik matejsemancik commented Mar 27, 2026

Copy link
Copy Markdown
Member

Summary

Introduces a full MkDocs Material documentation site for Arkitekt 6.x, deployed to GitHub Pages at arkitekt.futured.app. The README is replaced with a short pointer to the new site.

Changes

  • mkdocs.yml — Material theme config with macros plugin, custom Roobert font, and full navigation structure
  • docs/architecture/ — Android (single-page) and KMP (multi-page: Components, State, Events, Navigation, Factory Generator) architecture docs
  • docs/getting-started/ — Installation, project setup, and quick-start guides for both Android and KMP paths
  • docs/use-cases/ — UseCase, FlowUseCase, Result handling, and error handling docs
  • docs/testing/ — ViewModel testing, UseCase mocking, and component testing docs
  • docs/migration/android.md — Migration guide for upgrading to 6.x
  • docs/lint.md — Lint rules documentation
  • .github/workflows/publish_pages.yml — GitHub Pages deployment CI triggered on pushes to 6.x
  • README.md — Simplified to redirect users to the docs site

@matejsemancik matejsemancik marked this pull request as draft April 24, 2026 12:44
matejsemancik and others added 3 commits May 4, 2026 09:09
Reorganize docs into platform-first structure, add component testing
guide, expand migration docs into dedicated directory, and remove
outdated result.md page. Also remove deprecated BaseComponent APIs.

Co-Authored-By: Claude Sonnet 4.6 <[email protected]>
Remove inline docs, installation snippets, and feature list in favour
of a single link to the MkDocs site. Delete now-unused extras/ assets.

Co-Authored-By: Claude Sonnet 4.6 <[email protected]>
@matejsemancik matejsemancik requested a review from Syntey May 4, 2026 10:56
@matejsemancik matejsemancik changed the title 6.x: Create mkdocs pages 6.x: Create MkDocs documentation site May 4, 2026
@matejsemancik matejsemancik marked this pull request as ready for review May 4, 2026 10: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