You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: CONTRIBUTING.md
+15
Original file line number
Diff line number
Diff line change
@@ -54,6 +54,21 @@ translation PRs are opened within a week of the original newsletter being
54
54
published for new newsletters. That said, we also encourage translation of
55
55
older newsletters and blog posts as well.
56
56
57
+
### Reviewing changes to the website generation code
58
+
59
+
When reviewing changes to the Jekyll code that generates the website, it's useful to compare
60
+
the generated website before and after the change. To do so, you can run the following commands:
61
+
62
+
```bash
63
+
git checkout $reviewbranch# Checkout the branch that you want to review
64
+
rm -rf _site.bak # Remove the backup site directory if it exists
65
+
JEKYLL_ENV=local make build # Do a clean build of the site to the _site directory. The local env is to remove the 'updated' field which causes irrelevant diffs
66
+
mv _site _site.bak # Rename the generated site directory
67
+
git checkout master # Checkout the base branch
68
+
JEKYLL_ENV=local make build # Do a clean build of the site to the _site directory
69
+
diff -ruN _site _site.bak # Compare the generated sites (-r for recursive, -u for unified, -N for new file)
70
+
```
71
+
57
72
## Compatibility Matrix Data
58
73
59
74
The compatibility matrix section of the website is built from
0 commit comments