Skip to content

Latest commit

 

History

History

README.md

📚 StackCode Documentation

Welcome to the StackCode documentation hub! This directory contains comprehensive documentation for developers, contributors, and organizations using StackCode.

📋 Quick Navigation

🏗️ Core Documentation

🏛️ Architecture Decisions

🌐 Translations

🎯 Documentation by Audience

👩‍💻 For Developers Using StackCode

Start here if you want to use StackCode in your projects:

  1. Main README - Project overview and getting started
  2. Technology Stacks - See what project types are supported
  3. Self-Hosting Guide - Deploy for your organization

🛠️ For Contributors

Start here if you want to contribute to StackCode:

  1. Contributing Guide - How to contribute effectively
  2. Architecture Guide - Understand the codebase
  3. ADR Directory - Learn about architectural decisions

🏢 For Organizations

Start here if you want to deploy StackCode internally:

  1. Self-Hosting Guide - Deployment and customization
  2. Architecture Guide - Technical overview
  3. Contributing Guide - How to contribute improvements back

🔧 Technical Reference

Project Structure

docs/
├── README.md                 # This file
├── ARCHITECTURE.md           # Technical architecture
├── CONTRIBUTING.md           # Contribution guidelines
├── SELF_HOSTING_GUIDE.md     # Deployment guide
├── STACKS.md                 # Supported technologies
├── adr/                      # Architecture Decision Records
│   ├── README.md
│   ├── 001-monorepo-structure.md
│   ├── 002-typescript-esm.md
│   ├── 003-cli-design.md
│   └── 004-i18n-strategy.md
├── pt-BR/                    # Portuguese translations
│   └── README.md
└── es/                       # Spanish translations
    └── README.md

Key Concepts

  • Monorepo Architecture: StackCode uses a monorepo with multiple packages
  • Template System: Configurable project templates for different technologies
  • CLI + VS Code Extension: Multiple interfaces for the same core functionality
  • Internationalization: Multi-language support across all interfaces

🤝 Contributing to Documentation

We welcome improvements to our documentation! Here's how to help:

Quick Fixes

  • Fix typos, broken links, or unclear explanations
  • Add examples or improve existing ones
  • Update outdated information

Major Contributions

  • Write new guides or tutorials
  • Create documentation for new features
  • Help with translations

Translation Help

  • Translate existing documentation to your language
  • Review translations by other contributors
  • Maintain consistency across translations

See our Contributing Guide for detailed instructions.

🔗 External Resources

📞 Getting Help

Need help with StackCode?


Last updated: September 2025 | StackCode Documentation Team