# Personal Website - Joshua Michael Hall

This repository contains the source code for my personal website at [joshuamichaelhall.com](https://joshuamichaelhall.com), built with Jekyll and hosted on GitHub Pages.

## About Me

I'm a Cloud Business Strategist and former MSP owner pursuing Technical Account Manager roles in cloud/SaaS companies. With experience building and selling a $250K revenue MSP, I bring a unique business perspective to cloud transformation. My focus is on helping enterprises maximize cloud ROI while building toward a vision of acquiring and transforming traditional MSPs through AI and automation.

## Website Features

- **Professional Portfolio**: Cloud transformation case studies and business value demonstrations
- **Technical Blog**: Articles on cloud economics, customer success, and MSP transformation
- **Business Experience**: Detailed overview of my MSP journey and cloud expertise
- **Responsive Design**: Mobile-friendly layout for all screen sizes
- **Career Vision**: TAM to cloud consulting empire through MSP acquisitions

## Technical Stack

- **Static Site Generator**: Jekyll
- **Hosting**: GitHub Pages
- **CSS Framework**: Custom CSS built on Minima theme
- **CI/CD**: GitHub Actions for automated deployment
- **Form Handling**: Formspree
- **Analytics**: Google Analytics

## Repository Integration

This website integrates with several other repositories in my ecosystem:

### Integrated Repositories

1. **[tam-career-strategy](https://github.com/joshuamichaelhall/tam-career-strategy)**
   - TAM-to-Empire master strategy
   - Cloud business content and insights
   - MSP transformation frameworks
   
2. **[msp-acquisition-pipeline](https://github.com/joshuamichaelhall/msp-acquisition-pipeline)**
   - MSP acquisition pipeline
   - Industry relationship tracking
   - Cloud ecosystem networking

### Content Synchronization

The website's content is managed through:

1. **Blog Posts**: Markdown files in the `_posts` directory
2. **Project Data**: YAML files in `_data/projects.yml`
3. **Skills Data**: YAML files in `_data/skills.yml`

## Local Development

### Prerequisites

- Ruby version 2.7.0 or higher
- RubyGems
- GCC and Make

### Setup

1. Clone the repository:
   ```bash
   git clone https://github.com/JoshuaMichaelHall/joshuamichaelhall.github.io.git
   cd joshuamichaelhall.github.io
   ```

2. Install dependencies:
   ```bash
   bundle install
   ```

3. Run the development server:
   ```bash
   bundle exec jekyll serve
   ```

4. View the site at `http://localhost:4000`

## Project Structure

- `_config.yml`: Site configuration
- `_data/`: YAML files for structured data (skills, projects)
- `_includes/`: Reusable components
- `_layouts/`: Page layouts
- `_posts/`: Blog posts
- `assets/`: CSS, JavaScript, and images
- `pages/`: Main site pages

## Content Management

- **Blog Posts**: Add new posts to the `_posts` directory following the naming convention `YYYY-MM-DD-title.md`
- **Projects**: Update `_data/projects.yml` to add or modify portfolio projects
- **Skills**: Update `_data/skills.yml` to modify skill categories and proficiency levels

## Article Publishing Workflow

1. **Draft Creation**: Articles are drafted in private content strategy repository
2. **Format Conversion**: Markdown is prepared for website publication
3. **Integration**: Technical code samples are integrated from project repositories
4. **Publication**: Content is published to this repository via git
5. **Cross-Posting**: Published articles are automatically cross-posted to Dev.to

## Dev.to Integration

This repository includes a GitHub Action workflow that automatically publishes Markdown articles to Dev.to. See the `.github/workflows/devto-publish.yml` file for configuration details.

## Documentation Centralization

Documentation for related repositories is primarily maintained in those repositories:

- Project implementations are documented in their respective repositories
- Blog posts reference and link to the source repositories for detailed information

## License

This project is licensed under the MIT License - see the LICENSE file for details.

## Acknowledgements

This project was developed with assistance from Anthropic's Claude AI assistant, which helped with:
- Documentation writing and organization
- Code structure suggestions
- Troubleshooting and debugging assistance

Claude was used as a development aid while all final implementation decisions and code review were performed by Joshua Michael Hall.

## Disclaimer

This website is a work in progress. Some projects and content may be placeholders for future work. No liability is assumed for any inaccuracies or outdated information. Please report any issues or suggestions by contacting me directly.

---

> "Master the basics. Then practice them every day without fail." - John C. Maxwell