-
Notifications
You must be signed in to change notification settings - Fork 95
#1545: Fix release instructions for documentation [SKIP CI] #1610
Conversation
@girishshilamkar for the documentation changes .. it is better to add |
CONTRIBUTING.md
Outdated
@@ -337,6 +337,10 @@ docker run --rm --volume=$(pwd):/srv/jekyll -it jekyll/jekyll:stable jekyll buil | |||
# 4. Remove the old site and copy the new one. | |||
rm -rvf ../documentation | |||
mv _site ../documentation | |||
#Search for "Edit me" and ensure href is https://github.com/vmware/docker-volume-vsphere/edit/gh-pages/jekyll-docs//index.md |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
need to add # 5.
CONTRIBUTING.md
Outdated
@@ -337,6 +337,10 @@ docker run --rm --volume=$(pwd):/srv/jekyll -it jekyll/jekyll:stable jekyll buil | |||
# 4. Remove the old site and copy the new one. | |||
rm -rvf ../documentation | |||
mv _site ../documentation | |||
#Search for "Edit me" and ensure href is https://github.com/vmware/docker-volume-vsphere/edit/gh-pages/jekyll-docs//index.md | |||
#Bug in jekyll template does not render the name "index" | |||
vi ../documentation/index.html |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
can we supply a command to update this field automatically? .. like sed/awk command to update the line
BTW, manual addition works fine :-)
@@ -337,6 +337,10 @@ docker run --rm --volume=$(pwd):/srv/jekyll -it jekyll/jekyll:stable jekyll buil | |||
# 4. Remove the old site and copy the new one. |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Please improve the formatting .. It is easier to miss some step especially for index.md
part .. may be newline after each step would be better or anything else if you think of.
The stable docker image is updated and verified that images path is correct with this docker image.
Bug in jekyll template caused broken "edit me" link problem, added the step in release process to ensure it is correct.