Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Sync master/root README.md and provide a script to do this #831

Merged
merged 1 commit into from
Aug 13, 2019
Merged

Sync master/root README.md and provide a script to do this #831

merged 1 commit into from
Aug 13, 2019

Conversation

johnSchnake
Copy link
Contributor

What this PR does / why we need it:
The README for the master version of the docs and in the root
of the repo (used by Github) should always be in sync but
require minor changes due to different relative locations of
resources and links.

Also added this script as part of our CI to ensure that the two
files don't drift.

Which issue(s) this PR fixes
Fixes #772

Special notes for your reviewer:
Also found that there was drift; the master docs had a link to the page about wait functionality, but the root readme did not. The link wasn't actually used/needed so I removed it.

Release note:

NONE

@johnSchnake johnSchnake requested a review from zubron August 10, 2019 18:42
@codecov-io
Copy link

codecov-io commented Aug 10, 2019

Codecov Report

Merging #831 into master will not change coverage.
The diff coverage is n/a.

Impacted file tree graph

@@           Coverage Diff           @@
##           master     #831   +/-   ##
=======================================
  Coverage   44.68%   44.68%           
=======================================
  Files          75       75           
  Lines        4565     4565           
=======================================
  Hits         2040     2040           
  Misses       2392     2392           
  Partials      133      133

Continue to review full report at Codecov.

Legend - Click here to learn more
Δ = absolute <relative> (impact), ø = not affected, ? = missing data
Powered by Codecov. Last update f68cb44...6582942. Read the comment docs.

Copy link
Contributor

@zubron zubron left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

One minor thing to change but can be merged after fixing that. Thanks!

SCRIPTS_DIR="$( cd "$( dirname "$0" )" >/dev/null 2>&1 && pwd )"
DIR=$(cd $SCRIPTS_DIR; cd ..; pwd)
ROOT_README=$DIR/README.md
MASTER_SITE_README=./site/docs/master/README.md
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This should be $DIR/site/... so that it's independent of where it's being run from.

The README for the master version of the docs and in the root
of the repo (used by Github) should always be in sync but
require minor changes due to different relative locations of
resources and links.

Also added this script as part of our CI to ensure that the two
files don't drift.

Fixes #772

Signed-off-by: John Schnake <[email protected]>
@johnSchnake johnSchnake merged commit 94702fb into vmware-tanzu:master Aug 13, 2019
@johnSchnake johnSchnake deleted the readmeSync branch August 13, 2019 14:31
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

Automate doc maintenance as much as possible
3 participants