Skip to content

[DOCS] Added --skiplinkcheck parameter - #261

Merged
lcawl merged 3 commits into
elastic:masterfrom
lcawl:lcawley-mutelinkchecker
Nov 22, 2017
Merged

[DOCS] Added --skiplinkcheck parameter#261
lcawl merged 3 commits into
elastic:masterfrom
lcawl:lcawley-mutelinkchecker

Conversation

@lcawl

@lcawl lcawl commented Nov 21, 2017

Copy link
Copy Markdown
Contributor

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
Copy Markdown
Contributor

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

@lcawl

lcawl commented Nov 21, 2017

Copy link
Copy Markdown
Contributor Author

Good suggestion, @debadair, done!

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

@clintongormley clintongormley left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

Two niggles, otherwise LGTM

Comment thread build_docs.pl Outdated
check_links($build_dir);
}
push_changes($build_dir)
if $Opts->{push};

Copy link
Copy Markdown
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

Comment thread build_docs.pl Outdated
'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
Copy Markdown
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