Professional Jekyll documentation site showcasing enterprise-level React development practices
This repository contains the Jekyll documentation site that provides an in-depth technical analysis of Derek Mackley's developer portfolio. The documentation demonstrates sophisticated engineering practices, architectural decisions, and security-minded development approaches.
- Ruby 2.7+
- Bundler gem
- Jekyll 4.3+
# Clone the repository
git clone https://github.com/DapperDivers/developer-portfolio.git
cd developer-portfolio/docs
# Install Jekyll dependencies
bundle install
# Start local development server
bundle exec jekyll serve
# Open in browser
open http://localhost:4000This documentation is automatically deployed to GitHub Pages on push to the main branch.
docs/
├── _config.yml # Jekyll configuration
├── Gemfile # Ruby dependencies
├── index.md # Site homepage
├── _architecture/ # System architecture docs
├── _components/ # Component documentation
├── _guides/ # Development guides
├── _hooks/ # Custom hooks reference
├── _performance/ # Performance optimization
├── _security/ # Security practices
└── _testing/ # Testing strategies
- Create collection files in the appropriate
_collection/directory - Add Jekyll front matter with required fields:
--- layout: documentation title: "Page Title" description: "Page description" category: "Collection Name" order: 1 ---
- Follow naming conventions using kebab-case for filenames
The site uses Jekyll collections for organized content:
_architecture- System design and architectural patterns_components- Component development and design systems_guides- Development guides and best practices_hooks- Custom React hooks documentation_performance- Performance optimization techniques_security- Security implementation and practices_testing- Testing strategies and methodologies
# Build site locally
bundle exec jekyll build
# Serve with live reload
bundle exec jekyll serve --livereload
# Build for production
JEKYLL_ENV=production bundle exec jekyll buildThis documentation site serves as:
- Technical Showcase - Demonstrates professional development practices
- Knowledge Base - Comprehensive guides and references
- Professional Portfolio - Evidence of expertise across multiple domains
- Learning Resource - Best practices for modern web development
- Live Documentation Site - View the deployed documentation
- Portfolio Application - See the live portfolio
- Storybook Documentation - Interactive component library
This project is MIT licensed.
This documentation is part of Derek Mackley's professional portfolio. While primarily for demonstration purposes, suggestions and improvements are welcome through issues and pull requests.
Professional Jekyll documentation showcasing enterprise-level development practices and technical expertise.