docs: update README and CONTRIBUTING with new development tools
- Add Quick Start section to README with make commands - Add Development Tools section to CONTRIBUTING - Link to new documentation guides (QUICK_START.md, WORKFLOW_GUIDE.md) - Update development workflow section with modern tooling - Add clear onboarding path for new contributors Co-authored-by: jmiller-moko <230051081+jmiller-moko@users.noreply.github.com>
This commit is contained in:
65
README.md
65
README.md
@@ -134,6 +134,44 @@ If upgrading from a prior version, Joomla will safely overwrite files
|
||||
|
||||
For developers and contributors working on the moko-cassiopeia template:
|
||||
|
||||
### Quick Start for Developers
|
||||
|
||||
Get started in minutes:
|
||||
|
||||
```bash
|
||||
# Setup development environment
|
||||
make dev-setup
|
||||
|
||||
# Validate code
|
||||
make validate-required
|
||||
|
||||
# Check code quality
|
||||
make quality
|
||||
|
||||
# Create distribution package
|
||||
make package
|
||||
|
||||
# Install Git hooks (optional but recommended)
|
||||
./scripts/git/install-hooks.sh
|
||||
```
|
||||
|
||||
**New to the project?** See [Quick Start Guide](./docs/QUICK_START.md) for a 5-minute walkthrough.
|
||||
|
||||
### Development Resources
|
||||
|
||||
- **[Quick Start Guide](./docs/QUICK_START.md)** - Get up and running in 5 minutes
|
||||
- **[Workflow Guide](./docs/WORKFLOW_GUIDE.md)** - Complete workflow reference with examples
|
||||
- **[Joomla Development Guide](./docs/JOOMLA_DEVELOPMENT.md)** - Testing, quality checks, and deployment
|
||||
- **[Scripts Documentation](./scripts/README.md)** - Available automation scripts
|
||||
- **[Contributing Guide](./CONTRIBUTING.md)** - How to contribute
|
||||
|
||||
### Available Tools
|
||||
|
||||
- **Makefile**: Run `make help` to see all available commands
|
||||
- **Pre-commit Hooks**: Automatic validation before commits
|
||||
- **VS Code Tasks**: Pre-configured development tasks
|
||||
- **GitHub Actions**: Automated CI/CD pipelines
|
||||
|
||||
### Joomla Development Workflows
|
||||
|
||||
Comprehensive Joomla-aware development tools and workflows are available:
|
||||
@@ -141,32 +179,9 @@ Comprehensive Joomla-aware development tools and workflows are available:
|
||||
- **Extension Packaging** - Create distributable ZIP packages
|
||||
- **PHP Quality Checks** - PHPStan and PHP_CodeSniffer with Joomla standards
|
||||
- **Automated Testing** - Codeception framework with multiple Joomla versions
|
||||
- **CI/CD Pipelines** - GitHub Actions for testing and deployment
|
||||
- **CI/CD Pipelines** - GitHub Actions with caching for faster builds
|
||||
|
||||
See the [Joomla Development Guide](./docs/JOOMLA_DEVELOPMENT.md) for:
|
||||
- Setup instructions for local development
|
||||
- Running tests and quality checks
|
||||
- Creating release packages
|
||||
- Deployment workflows
|
||||
- CI/CD pipeline details
|
||||
|
||||
### Quick Start for Developers
|
||||
|
||||
```bash
|
||||
# Validate code
|
||||
./scripts/validate/php_syntax.sh
|
||||
./scripts/validate/manifest.sh
|
||||
|
||||
# Create distribution package
|
||||
./scripts/release/package_extension.sh dist 3.5.0
|
||||
|
||||
# Run tests (requires Codeception)
|
||||
codecept run
|
||||
|
||||
# Check code quality (requires PHPStan/PHPCS)
|
||||
phpstan analyse --configuration=phpstan.neon
|
||||
phpcs --standard=phpcs.xml
|
||||
```
|
||||
Run `make help` to see all available development commands.
|
||||
|
||||
## Changelog
|
||||
|
||||
|
||||
Reference in New Issue
Block a user