Skip to content

[DOCS] Added --skiplinkcheck parameter #261

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

Merged
merged 3 commits into from
Nov 22, 2017
Merged

[DOCS] Added --skiplinkcheck parameter #261

merged 3 commits into from
Nov 22, 2017

Conversation

lcawl
Copy link
Contributor

@lcawl lcawl commented Nov 21, 2017

Related to #249

This PR adds the --nolinkcheck parameter, which skips the step that checks links at the end of a --all build. For example, you can use it as follows:

./build_docs.pl —all —nolinkcheck
...
Writing main TOC
Writing extra HTML redirects
Skipped Checking links

This is required for when a broken link is preventing us from successfully publishing the documentation in a time-critical situation.

The expectation is that any broken links would be fixed as soon as possible and link checking would be resumed immediately thereafter.

@lcawl lcawl added the docs DO NOT USE for *contents* of our docs. Only use for documentation *about* this repo. label Nov 21, 2017
@lcawl lcawl requested a review from clintongormley November 21, 2017 21:01
@debadair
Copy link
Contributor

I'd pull the push out of the nolinkcheck if/else, other than that LGTM.

@lcawl
Copy link
Contributor Author

lcawl commented Nov 21, 2017

Good suggestion, @debadair, done!

@debadair debadair mentioned this pull request Nov 22, 2017
2 tasks
Copy link
Contributor

@clintongormley clintongormley left a comment

Choose a reason for hiding this comment

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

Two niggles, otherwise LGTM

build_docs.pl Outdated
check_links($build_dir);
}
push_changes($build_dir)
if $Opts->{push};
Copy link
Contributor

Choose a reason for hiding this comment

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

niggle - indent the if line

build_docs.pl Outdated
@@ -51,7 +51,7 @@ BEGIN
$Opts, #
'all', 'push', 'update!', #
'single', 'pdf', 'doc=s', 'out=s', 'toc', 'chunk=i',
'open', 'staging', 'procs=i', 'user=s', 'lang=s',
'open', 'nolinkcheck', 'staging', 'procs=i', 'user=s', 'lang=s',
Copy link
Contributor

Choose a reason for hiding this comment

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

let's call it skiplinkcheck instead of nolinkcheck

@lcawl lcawl merged commit b9b7d09 into elastic:master Nov 22, 2017
@lcawl lcawl deleted the lcawley-mutelinkchecker branch November 22, 2017 16:54
@lcawl lcawl changed the title [DOCS] Added --nolinkcheck parameter [DOCS] Added --skiplinkcheck parameter Nov 22, 2017
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
docs DO NOT USE for *contents* of our docs. Only use for documentation *about* this repo.
Projects
None yet
Development

Successfully merging this pull request may close these issues.

3 participants