Skip to content

docs: add comprehensive project documentation#16

Open
marcuskbra wants to merge 3 commits intoAdventech:stagefrom
marcuskbra:docs/add-project-documentation
Open

docs: add comprehensive project documentation#16
marcuskbra wants to merge 3 commits intoAdventech:stagefrom
marcuskbra:docs/add-project-documentation

Conversation

@marcuskbra
Copy link
Copy Markdown

Summary

Closes #8

This PR adds comprehensive project documentation to help new contributors get started with the sabbath-school-web project.

Changes

New Files

  • CONTRIBUTING.md - Complete contribution guide with:

    • Development setup instructions
    • Coding standards (Vue 3 Composition API, naming conventions)
    • Git workflow and commit message format
    • Pull request process
    • Manual testing checklist
  • docs/ARCHITECTURE.md - Technical architecture documentation covering:

    • Multi-site system (hostname-based routing)
    • Component hierarchy and communication patterns
    • State management with Pinia
    • API layer with 4 Axios instances
    • Plugin system (Bible, Highlighter, ContextMenu, Theme)
    • Block system with 20+ content types
    • Theme system with TailwindCSS variants
    • Internationalization and RTL support
  • docs/API.md - API reference including:

    • All API endpoints (v2 Sabbath School, v3 Resources)
    • Authentication flow with token refresh
    • Request/response formats
    • Error handling patterns
  • CLAUDE.md - AI assistant guidance for codebase navigation

Modified Files

  • README.md - Enhanced with:

    • Project overview and features list
    • Sites served table
    • Tech stack with versions
    • Quick start guide
    • Project structure overview
    • Environment configuration
    • Links to detailed documentation
  • .gitignore - Added .serena/ for local development tooling

Test Plan

  • Verified all markdown files render correctly
  • Verified links between documentation files work
  • Build succeeds with yarn build

Closes Adventech#8

Add project documentation to help new contributors get started:

- README.md: Enhanced with features, tech stack, quick start guide,
  project structure, and environment configuration
- CONTRIBUTING.md: Complete contribution guide with coding standards,
  Vue 3 Composition API patterns, git workflow, and PR process
- CLAUDE.md: AI assistant guidance for codebase navigation
- docs/ARCHITECTURE.md: Technical architecture covering multi-site
  system, block system, plugins, themes, and i18n
- docs/API.md: API reference with endpoints, authentication flow,
  and error handling

Also adds .serena/ to .gitignore for local development tooling.
@marcuskbra
Copy link
Copy Markdown
Author

Hey @VitalikL! Hope you're doing well! Would you mind taking a moment to review this PR? Your feedback would be greatly appreciated! Thank you!

@marcuskbra marcuskbra closed this Jan 17, 2026
@marcuskbra marcuskbra deleted the docs/add-project-documentation branch January 17, 2026 15:19
@VitalikL
Copy link
Copy Markdown
Member

Hi @marcuskbra ! Thank you, appreciate your help. I can review over the weekend, but I see it's closed now

@marcuskbra marcuskbra restored the docs/add-project-documentation branch January 17, 2026 19:09
@marcuskbra marcuskbra reopened this Jan 17, 2026
@marcuskbra
Copy link
Copy Markdown
Author

Hi @VitalikL. I apologize for the mistake; I accidentally deleted the branch, but it has now been reopened.

Comment thread docs/API.md Outdated
Comment thread docs/API.md Outdated
@marcuskbra marcuskbra requested a review from VitalikL February 25, 2026 03:45
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.

Missing project contribution guidelines

2 participants