The VMware Tanzu Developer Center uses Hugo to build the site from Markdown files. You'll need to get Hugo if you want to build and run the site locally.
To install the latest version of hugo you can use brew install hugo if you are on a Mac. This site pins hugo to a specific version (currently 0.82.0) to build so if you're using a different version, your experience may vary.
To build the site:
git clone https://github.com/vmware-tanzu/tanzu-dev-portal
cd tanzu-dev-portal
make preview
A preview of the dev portal will be available at: http://localhost:1313/developer.
Note: requires Docker to be running (On Mac OS X requires Docker Desktop 2.4 or newer)
- Install act (
brew install act) - Run
make test
A GitHub action will run after opening a Pull Request that checks spelling. (You may test this locally using make spell.) You can add entries to the custom_dict.txt file for words that should not be flagged. This file gets sorted as a pre-commit hook so you can just add your entries to the end of the file and not worry about the order.
After running and testing locally, opened Pull Requests will be automatically staged by Netlify.
See the Contributors guide.