Skip to content
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 make target to serve docs locally #840

Merged

Conversation

danielmitterdorfer
Copy link
Member

With this commit we add the make target serve-docs which starts a web
server locally so docs changes can be easily checked.

With this commit we add the make target `serve-docs` which starts a web
server locally so docs changes can be easily checked.
@danielmitterdorfer danielmitterdorfer added enhancement Improves the status quo :misc Changes that don't affect users directly: linter fixes, test improvements, etc. labels Dec 16, 2019
@danielmitterdorfer danielmitterdorfer added this to the 1.4.0 milestone Dec 16, 2019
@danielmitterdorfer danielmitterdorfer self-assigned this Dec 16, 2019
Copy link
Contributor

@hub-cap hub-cap left a comment

Choose a reason for hiding this comment

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

lgtm, w/ one question/suggestion.

Makefile Outdated
@@ -92,6 +92,9 @@ lint: check-venv
docs: check-venv
cd docs && $(MAKE) html

serve-docs: docs
@cd docs/_build/html && python3 -m http.server
Copy link
Contributor

Choose a reason for hiding this comment

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

Since the docs/Makefile already has a make serve, it might make sense to do cd docs && $(MAKE) serve instead.

Copy link
Member Author

Choose a reason for hiding this comment

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

Good catch. Let's use that.

@hub-cap
Copy link
Contributor

hub-cap commented Dec 18, 2019

@elasticmachine run tests

@danielmitterdorfer danielmitterdorfer merged commit 93b1f52 into elastic:master Dec 19, 2019
@danielmitterdorfer danielmitterdorfer deleted the add-serve-docs-target branch December 19, 2019 07:19
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
enhancement Improves the status quo :misc Changes that don't affect users directly: linter fixes, test improvements, etc.
Projects
None yet
Development

Successfully merging this pull request may close these issues.

2 participants