Non-technical contributors can refer to the visual guide here:
https://cloudstack.apache.org/website-guide/
or,
https://github.com/apache/cloudstack-www/tree/main/docs/
For adding blog posts, the following template can be copied and renamed in the format as -blog-name, see examples in the blog directory:
https://github.com/apache/cloudstack-www/tree/main/blog/.blog-template
<your_github_user>
. To do that, navigate to https://github.com/apache/cloudstack-www
and click fork
in the top right corner of the page.git clone git@github.com:<your_github_user>/cloudstack-www.git
origin
remote.cd cloudstack-www
upstream
remote: git remote add upstream git@github.com:apache/cloudstack-www.git
Sync Local with Upstream
git checkout main
git fetch upstream
git pull upstream main
Commit Locally
Once you've made local changes and tested locally if you can, you may commit your changes as follows:
git add . git commit -am "your commit message" git push origin main
Create a PR
main
on the https://github.com/apache/cloudstack-www
repository.COMMITTER: Validate a PR Locally Note: The following instructions assume the <contributor>
made their changes on their main
branch.
# validate contributor changes cd /tmp git clone https://github.com/<contributor>/cloudstack-www.git cd cloudstack-www git checkout main yarn install yarn build # visually validate changes at: http://localhost:[3000|port number]
COMMITTER: Merge & Deploy
Once a PR is merged into main
branch using GitHub UI, the changes are made live by a GitHub Actions based automation workflow.