Skip to content

build: build docs on Travis - #29783

Closed
richardlau wants to merge 1 commit into
nodejs:masterfrom
richardlau:travis-docs
Closed

build: build docs on Travis#29783
richardlau wants to merge 1 commit into
nodejs:masterfrom
richardlau:travis-docs

Conversation

@richardlau

@richardlaurichardlau commented Sep 30, 2019•
edited
Loading

Copy link
Copy Markdown
Member

Build the docs on Travis. This is a prerequisite for #29770.

Checklist
  • make -j4 test (UNIX), or vcbuild test (Windows) passes
  • commit message follows commit guidelines

@nodejs-github-botnodejs-github-bot added the build Issues and PRs related to build files or the CI. label Sep 30, 2019
@richardlaurichardlau added the wip Issues and PRs that are still a work in progress. label Sep 30, 2019
@richardlau

This comment has been minimized.

Sign in to view
@richardlaurichardlau changed the title build: build and test docs on Travisbuild: build docs on TravisSep 30, 2019
@richardlau

richardlau commented Sep 30, 2019•
edited
Loading

Copy link
Copy Markdown
MemberAuthor

The test-doc make target runs:

  • the doc-only target to build the docs (our Travis builds weren't doing this)
  • lint target (our Travis builds already does this)
  • runs the doctool tests (our Travis builds weren't doing this)

It looks like the doctool tests test the code to generate the docs -- I'd consider such code to not be a "doc-only" change and am thus arguing we don't need to run doctool tests on Travis.

This PR adds the doc-only target so that the docs are built as well as linted.

node/Makefile

Lines 601 to 608 in 2487f39

.PHONY: test-doc
test-doc: doc-only ## Builds, lints, and verifies the docs.
@if [ "$(shell $(node_use_openssl))"!="true" ];then\
echo"Skipping test-doc (no crypto)";\
else\
$(MAKE) lint;\
$(PYTHON) tools/test.py $(PARALLEL_ARGS) doctool;\
fi

@richardlaurichardlau removed the wip Issues and PRs that are still a work in progress. label Sep 30, 2019
@TrottTrott added the author ready PRs that have at least one approval, no pending requests for changes, and a CI started. label Oct 3, 2019
@Trott

Trott commented Oct 3, 2019

Copy link
Copy Markdown
Member

Lite CI: https://ci.nodejs.org/job/node-test-pull-request-lite-pipeline/3967/

Trott pushed a commit that referenced this pull request Oct 3, 2019
@richardlau@Trott
build: build docs on Travis
b5e40ba
PR-URL: #29783
Reviewed-By: Ruben Bridgewater <ruben@bridgewater.de>
Reviewed-By: Rich Trott <rtrott@gmail.com>
Reviewed-By: Trivikram Kamat <trivikr.dev@gmail.com>
@Trott

Trott commented Oct 3, 2019

Copy link
Copy Markdown
Member

Landed in b5e40ba

@TrottTrott closed this Oct 3, 2019
BridgeAR pushed a commit that referenced this pull request Oct 9, 2019
@richardlau@BridgeAR
build: build docs on Travis
d09f2b4
PR-URL: #29783
Reviewed-By: Ruben Bridgewater <ruben@bridgewater.de>
Reviewed-By: Rich Trott <rtrott@gmail.com>
Reviewed-By: Trivikram Kamat <trivikr.dev@gmail.com>
@richardlaurichardlau mentioned this pull request Oct 9, 2019
Closed
@BridgeARBridgeAR mentioned this pull request Oct 10, 2019
Merged
@richardlaurichardlau mentioned this pull request Dec 16, 2019
Closed
Sign up for freeto join this conversation on GitHub. Already have an account? Sign in to comment

Reviewers

@TrottTrottTrott approved these changes
@BridgeARBridgeARBridgeAR approved these changes
@trivikrtrivikrtrivikr approved these changes

Assignees

No one assigned

Labels

author readyPRs that have at least one approval, no pending requests for changes, and a CI started.buildIssues and PRs related to build files or the CI.

Projects

None yet

Milestone

No milestone

Development

Successfully merging this pull request may close these issues.

5 participants

@richardlau@Trott@BridgeAR@trivikr@nodejs-github-bot