jasperf · Oct 28, 2026 · Oct 28, 2026
diff --git a/AGENTS.md b/AGENTS.md
@@ -1,7 +1,7 @@
 # Repository Guidelines
 
 ## Project Structure & Module Organization
-- **trellis/** - Trellis-specific: `backup/`, `monitoring/`, `provision/`, `updater/`
+- **trellis/** - Trellis-specific: `backup/`, `monitoring/`, `updater/`
 - **wp-cli/** - WordPress CLI tools: `content-creation/`, `diagnostics/`, `migration/`
 - **scripts/** - Utilities: `backup/`, `monitoring/`, `git/create-pr.sh`, `sync/rsync-theme.sh`
 - **docs/** - Design docs at the top level; guides in subdirectories: `nginx/` (server configs), `troubleshooting/` (server/WP), `bedrock/` (Composer workflows), `wordpress-utilities/` (copy-paste components)

diff --git a/CHANGELOG.md b/CHANGELOG.md
@@ -9,6 +9,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ### Removed
 
+- **The provisioning and updater guides**, now four posts on wpvilla.in: [a new Mac for Trellis](https://wpvilla.in/new-mac-trellis-development-setup-lima-composer-node/), [cloning an existing project](https://wpvilla.in/clone-trellis-bedrock-project-lima-vm-first-provision/), [updating Trellis](https://wpvilla.in/update-trellis-without-losing-customisations-rsync-excludes/) and [provision tags and the PHP upgrade](https://wpvilla.in/trellis-provision-tags-php-version-upgrade-checklist/). The cron guide is covered by the existing [WP-Cron interval post](https://wpvilla.in/trellis-wp-cron-interval-scheduled-posts-late-cron-interval/). `trellis/provision/` is gone, as are the updater README and `manual-update.md`; the `trellis-updater` script stays.
 - **The content-creation guides**, now three posts on wpvilla.in: [creating pages from block markup](https://wpvilla.in/create-wordpress-pages-block-markup-wp-cli-trellis-vm-production/), [block patterns as PHP files](https://wpvilla.in/wordpress-block-pattern-php-files-headers-escaping-images/) and [pattern layout rules](https://wpvilla.in/wordpress-block-pattern-layout-alignfull-grid-spacing-rules/). `PAGE-CREATION.md`, `PATTERN-REQUIREMENTS.md` and the folder README are gone; the scripts and the example stay.
 - **The migration guides**, now four posts on wpvilla.in: [migrating a site to Trellis and Bedrock](https://wpvilla.in/migrate-wordpress-to-trellis-bedrock-step-by-step/), [testing before the DNS cutover](https://wpvilla.in/trellis-migration-test-etc-hosts-letsencrypt-dns-cutover/), [migrating several sites onto one server](https://wpvilla.in/migrate-multiple-wordpress-sites-one-trellis-server/) and [wp search-replace for domain and path changes](https://wpvilla.in/wp-search-replace-wordpress-url-domain-https-bedrock-paths/). `wp-cli/migration/` is gone, and the README, `CLAUDE.md` and `wp-cli/README.md` no longer point at it.
 - **The documentation feature.** The guides are moving to [wpvilla.in](https://wpvilla.in/), so wp-ops no longer searches or links documentation.

diff --git a/CLAUDE.md b/CLAUDE.md
@@ -11,7 +11,6 @@ This is a collection of tools, scripts, and documentation for WordPress operatio
 - **trellis/** - Trellis-specific tools and workflows
   - `trellis/backup/` - Ansible playbooks for database/files backup, pull, and push operations
   - `trellis/monitoring/` - Nginx log monitoring and traffic analysis
-  - `trellis/provision/` - Provisioning guides and command reference
   - `trellis/security/` - fail2ban WordPress protection and manual IP blocking guides
   - `trellis/updater/` - Safe Trellis update scripts
 - **wp-cli/** - WordPress command-line operations

diff --git a/README.md b/README.md
@@ -129,7 +129,7 @@ sites are run with:
 
 | Area | What's there | Docs |
 |------|--------------|------|
-| **Trellis** | Safe Trellis updates, provisioning reference, new-machine and project setup | [updater](trellis/updater/README.md) · [provision](trellis/provision/README.md) |
+| **Trellis** | Safe Trellis updates (`trellis-updater`) | [guide](https://wpvilla.in/update-trellis-without-losing-customisations-rsync-excludes/) |
 | **Backups** | Timestamped database and uploads backups from any environment | [→](trellis/backup/README.md) |
 | **Monitoring** | AI-crawler traffic, error surfacing, traffic by country, cron-scheduled reports | [→](trellis/monitoring/README.md) |
 | **Security** | Malware scanners with checksum verification, fail2ban, manual IP blocking, AbuseIPDB lookup | [scanners](wp-cli/security/README.md) · [server](trellis/security/README.md) |

diff --git a/trellis/README.md b/trellis/README.md
@@ -20,7 +20,6 @@ This directory contains production-ready tools for:
 trellis/
 ├── backup/          # Database & file sync Ansible playbooks
 ├── monitoring/      # Nginx log analysis & security monitoring
-├── provision/       # Server setup & configuration guides
 ├── security/        # WordPress security tools (fail2ban, IP blocking)
 └── updater/         # Safe Trellis version upgrade tools
 ```
@@ -268,49 +267,12 @@ ssh web@yoursite.com "grep 'POST.*wp-login' /srv/www/yoursite.com/logs/access.lo
 
 ## 4. Provisioning & Setup
 
-**Location:** `provision/`
+The provisioning guides are on the blog:
 
-Documentation and guides for server provisioning, configuration, and WordPress cron management.
-
-### Documentation
-
-| File | Purpose |
-|------|---------|
-| `README.md` | Quick provisioning command reference |
-| `CRON.md` | WordPress cron system configuration |
-| `NEW-MACHINE.md` | New server setup guide |
-| `PROJECT-SETUP.md` | Initial project setup guide |
-
-### Key Topics
-
-**Provisioning Commands**
-- Development environment setup
-- Staging/production deployment
-- PHP version upgrades with correct tags
-- Nginx configuration updates
-
-**WordPress Cron Configuration**
-- WP-Cron vs system cron
-- Trellis default: system cron every 15 minutes
-- Multisite cron configuration
-- Verification and troubleshooting
-
-**PHP Version Upgrades**
-
-When upgrading PHP, **must** include these tags:
-
-```bash
-trellis provision --tags php,nginx,wordpress-setup,users,memcached production
-```
-
-Critical tags:
-- `php` - Installs new version
-- `nginx` - Updates PHP-FPM socket configuration
-- `wordpress-setup` - Creates PHP version-specific pool configuration
-- `users` - **Critical**: Updates sudoers for PHP-FPM reload (deployments fail without this)
-- `memcached` - Installs version-specific memcached extension
-
-**See also:** [provision/README.md](provision/README.md) and subdirectory documentation.
+- [Setting up a new Mac for Trellis development](https://wpvilla.in/new-mac-trellis-development-setup-lima-composer-node/)
+- [Cloning an existing Trellis and Bedrock project](https://wpvilla.in/clone-trellis-bedrock-project-lima-vm-first-provision/)
+- [Trellis provision tags and the PHP upgrade](https://wpvilla.in/trellis-provision-tags-php-version-upgrade-checklist/)
+- [WP-Cron on Trellis: the interval and how to change it](https://wpvilla.in/trellis-wp-cron-interval-scheduled-posts-late-cron-interval/)
 
 ---
 
@@ -354,9 +316,7 @@ git add -A
 git commit -m "Update Trellis to latest version"
 ```
 
-**See also:**
-- [updater/README.md](updater/README.md) - Complete updater documentation
-- [updater/manual-update.md](updater/manual-update.md) - Manual update instructions
+**See also:** [Updating Trellis without losing your customisations](https://wpvilla.in/update-trellis-without-losing-customisations-rsync-excludes/)
 
 ---