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
Updated the build to match the website changes: #2034
Conversation
tpoterba
commented
Jul 27, 2017
- fixed structure of docs + links (hail/* -> docs/stable/*)
- Added Hail version + supported spark versions + git hash as gradle variables
- Used these versions in Sphinx.
- Changed path of distribution links in getting started to point at current hash.
- fixed structure of docs + links (hail/* -> docs/stable/*) - Added Hail version + supported spark versions + git hash as gradle variables - Used these versions in Sphinx. - Changed path of distribution links in getting started to point at current hash.
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.
Looks good!
python/hail/docs/conf.py
Outdated
version = u'0.1' | ||
version = os.environ['HAIL_VERSION'] | ||
release = os.environ['HAIL_RELEASE'] | ||
# version = u'0.1' |
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.
Delete if no longer needed.
build.gradle
Outdated
@@ -355,7 +366,7 @@ task cleanHailDocs(type: Exec) { | |||
} | |||
|
|||
task setupDocsDirs(type: Exec, dependsOn: cleanHailDocs) { | |||
commandLine 'mkdir', '-p', 'build/tmp/docs/', 'build/www/', 'build/tmp/python/' | |||
commandLine 'mkdir', '-p', 'build/tmp/', 'build/www/', 'build/tmp/python/', 'build/tmp/docs', 'build/www/docs' |
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.
AFAIK, you shouldn't need build/tmp/
if you're using mkdir -p build/tmp/docs
String hailVersion = "0.1" | ||
String[] supportedSparkVersions = ["2.0.2", "2.1.0"] | ||
String gitHash = exec {commandLine 'git', 'rev-parse', '--short', 'HEAD'} | ||
|
||
String sparkVersion = System.getProperty("spark.version","2.0.2") | ||
|
||
if (!(sparkVersion ==~ /^2\..*/)) |
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.
Should we start using supportedSparkVersions
instead?
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.
no, because the cdh deployments have weird names and we don't want to have to keep track of those explicitly.
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.
the supportedSparkVersions are the deployed ones
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.
maybe we should rename that 👍
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.
agreed.
python/hail/docs/conf.py
Outdated
# The full version, including alpha/beta/rc tags. | ||
release = u'0.1' | ||
# release = u'0.1' |
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.
delete
|
||
echo "Hail uploads distributions to Google Storage as part of our continuous integration suite." >> $TARGET | ||
|
||
echo "You can download a pre-built distribution from the below links. Make sure you download the distribution that matches your Spark version!" >> $TARGET |
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.
looks like you might be short one newline compared to the current text. Is that correct?
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.
I think it looks better as one paragraph, the line break is a bit disruptive. This was intentional
* Updated the build to match the website changes: - fixed structure of docs + links (hail/* -> docs/stable/*) - Added Hail version + supported spark versions + git hash as gradle variables - Used these versions in Sphinx. - Changed path of distribution links in getting started to point at current hash. * Fix sphinx version comments * Fix up build
* Updated the build to match the website changes: - fixed structure of docs + links (hail/* -> docs/stable/*) - Added Hail version + supported spark versions + git hash as gradle variables - Used these versions in Sphinx. - Changed path of distribution links in getting started to point at current hash. * Fix sphinx version comments * Fix up build
* Updated the build to match the website changes: - fixed structure of docs + links (hail/* -> docs/stable/*) - Added Hail version + supported spark versions + git hash as gradle variables - Used these versions in Sphinx. - Changed path of distribution links in getting started to point at current hash. * Fix sphinx version comments * Fix up build