-
Notifications
You must be signed in to change notification settings - Fork 4k
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
Add publish.sh to publish to NPM-JS and Github Pages. #429
Conversation
publish.sh
Outdated
) | ||
|
||
git clone -b gh-pages --depth=1 ssh://github.com/awslabs/aws-cdk ${GIT_REPO} | ||
rsync -ar --delete --exclude=/.git ${DOC_STAGING}/node_modules/aws-cdk-docs/dist/docs/ ${GIT_REPO}/ |
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.
We need to maintain docs for all versions so it will be possible to point to a specific version when referencing the docs. So I think we should publish the docs to a per-version directory (i.e. /v0.7.3-beta) and /also/ publish the latest docs to the root (or just generate an index.html at the root with a redirect metadata). Thoughts?
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.
Yeah - I've added code to copy the released doc both to the root and to a versions/${version-number}
directory.
|
||
const browserCommand = argv.browser.replace(/%u/g, documentationIndexPath); | ||
const docVersion = require('../../package.json').version; | ||
const browserCommand = argv.browser.replace(/%u/g, `https://awslabs.github.io/aws-cdk/versions/${docVersion}/`); |
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 opportunistically make someone happy?
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.
Yes - just added a change to make the URL extra-visible if we couldn't start the browser.
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.
Go for it
By submitting this pull request, I confirm that my contribution is made under the terms of the Apache-2.0 license.