Skip to content

Migrate user documentation to GitHub Wiki#193

Merged
kirich1409 merged 1 commit into
developfrom
docs/wiki-migration
May 18, 2026
Merged

Migrate user documentation to GitHub Wiki#193
kirich1409 merged 1 commit into
developfrom
docs/wiki-migration

Conversation

@kirich1409
Copy link
Copy Markdown
Contributor

Summary

  • README slimmed from 590 → 75 lines: badges, intro, 5 highlight bullets (DCE called out), one end-to-end Kotlin example, links to Wiki.
  • User-facing documentation moved to https://github.com/AndroidBroadcast/Featured/wiki (17 topic-organized pages with a dedicated Release-Optimization page that leads with the tl;dr: a flag with default = false makes guarded code unreachable in release builds).
  • mkdocs setup removed: mkdocs.yml, docs/{guides,index,getting-started,ios-integration,known-limitations,changelog,api}, and .github/workflows/docs.yml.
  • Kept docs/cc-verification/ and docs/specs/ as internal audit/spec history.
  • Swift code comments updated to point at the new Wiki page instead of the deleted docs/ios-integration.md.
  • .gitignore hardened: secring.gpg, *.gpg, .build/, .claude/agent-memory/, .claude/scheduled_tasks.lock added.

Wiki structure

Topic Page
Start Home, Getting-Started, Installation
Core Declaring-Flags, Reading-Flags-Kotlin, iOS-Usage, Providers
Release builds (DCE) Release-Optimization, Android-DCE-R8, iOS-DCE-xcconfig
Advanced Multi-Module-Setup, Configuration-Cache, Best-Practices, Known-Limitations, Debug-UI, Sample-App

Out of scope (follow-ups)

  • Debug UI screenshots — sample app currently crashes on launch due to an enum flag (CheckoutVariant) not being supported by DataStoreConfigValueProvider. Tracked separately; screenshots will land in a follow-up Wiki commit after the sample is fixed.
  • Dokka publishing to gh-pages — separate workflow, to be added later.

Test plan

  • CI green on docs/wiki-migration
  • README renders correctly on GitHub (badges, code blocks, links)
  • Wiki pages render correctly, _Sidebar shows on every page
  • All Wiki cross-links resolve (no 404)
  • iOS Swift code still compiles after comment changes

- Replace 590-line README with a 75-line landing page that links to the Wiki and showcases a single end-to-end example
- Delete mkdocs.yml, docs/{guides,index,getting-started,ios-integration,known-limitations,changelog,api}, and the docs publish workflow — content moved to the Wiki at https://github.com/AndroidBroadcast/Featured/wiki
- Keep docs/cc-verification/ and docs/specs/ as internal audit/spec history
- Update Swift comments referencing docs/ios-integration.md to point at the new Wiki page
- Ignore secring.gpg, .build/, .claude runtime files in .gitignore

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
@kirich1409 kirich1409 force-pushed the docs/wiki-migration branch from ce44952 to 8a7c061 Compare May 18, 2026 11:13
@kirich1409 kirich1409 marked this pull request as ready for review May 18, 2026 11:23
Copilot AI review requested due to automatic review settings May 18, 2026 11:23
@qodo-code-review
Copy link
Copy Markdown

Qodo reviews are paused for this user.

Troubleshooting steps vary by plan Learn more →

On a Teams plan?
Reviews resume once this user has a paid seat and their Git account is linked in Qodo.
Link Git account →

Using GitHub Enterprise Server, GitLab Self-Managed, or Bitbucket Data Center?
These require an Enterprise plan - Contact us
Contact us →

Copy link
Copy Markdown

@cubic-dev-ai cubic-dev-ai Bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

No issues found across 18 files

Tip: cubic can generate docs of your entire codebase and keep them up to date. Try it here.

Re-trigger cubic

Copy link
Copy Markdown

Copilot AI left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

This PR migrates user-facing documentation from in-repository MkDocs pages to the GitHub Wiki, leaving the README as a compact project entry point while retaining internal audit/spec docs.

Changes:

  • Replaces the long README with highlights, a quick Kotlin example, and Wiki links.
  • Removes MkDocs configuration, user documentation pages, and the docs publishing workflow.
  • Updates Swift sample comments to link to the new Wiki and expands .gitignore for local/generated files.

Reviewed changes

Copilot reviewed 17 out of 18 changed files in this pull request and generated 2 comments.

Show a summary per file
File Description
README.md Slims README and redirects users to Wiki documentation.
mkdocs.yml Removes MkDocs site configuration.
iosApp/iosApp/FeatureFlags.swift Updates iOS DCE guide link to Wiki.
iosApp/iosApp/ContentView.swift Updates sample setup comment to Wiki link.
docs/known-limitations.md Removes migrated user-facing limitations page.
docs/ios-integration.md Removes migrated iOS integration guide.
docs/index.md Removes MkDocs landing page.
docs/guides/r8-verification.md Removes migrated R8 verification guide.
docs/guides/providers.md Removes migrated providers guide.
docs/guides/jvm.md Removes migrated JVM guide.
docs/guides/ios.md Removes migrated iOS guide.
docs/guides/best-practices.md Removes migrated best-practices guide.
docs/guides/android.md Removes migrated Android guide.
docs/getting-started.md Removes migrated getting-started guide.
docs/changelog.md Removes migrated docs changelog page.
docs/api/index.md Removes migrated API reference page.
.gitignore Adds ignores for local Wiki/Claude/build/signing artifacts.
.github/workflows/docs.yml Removes MkDocs/Dokka Pages publishing workflow.

// FeatureFlags.generated.xcconfig when @LocalFlag new_checkout has
// defaultValue = false. The compiler removes this block in Release.
// See FeatureFlags.swift and docs/ios-integration.md for setup.
// See FeatureFlags.swift and https://github.com/AndroidBroadcast/Featured/wiki/iOS-DCE-xcconfig for setup.
Comment thread README.md
Comment on lines +50 to +51
// Read the generated extension anywhere
val isEnabled: Boolean = configValues.isNewCheckoutEnabled()
@kirich1409 kirich1409 merged commit 0a1d38b into develop May 18, 2026
13 checks passed
@kirich1409 kirich1409 deleted the docs/wiki-migration branch May 18, 2026 11:28
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.

2 participants