Skip to content

Conversation

@klwetstone
Copy link
Contributor

  • Fixes incorrect reference in watch of mkdocs.yml so building docs locally works
  • Adds a makefile command for make docs-serve that serves the docs on a site locally

The standard mkdocs project setup actually has mkdocs.yml in the project root, and would build docs/ into site/ (as opposed to docs/docs/ into docs/site/). We've wrapped things into a subdirectory layer of docs/ that is non-standard to keep the root level cleaner (credit to Jay for the explanation!). To refer to the right place when building docs locally, we need:

watch:
    ../cloudpathlib

Instead of

watch:
   cloudpathlib

In mkdocs.yml

@klwetstone klwetstone requested a review from jayqi October 20, 2021 13:39
@github-actions
Copy link
Contributor

github-actions bot commented Oct 20, 2021

@codecov
Copy link

codecov bot commented Oct 20, 2021

Codecov Report

Merging #178 (53a3b06) into master (cce6a2f) will not change coverage.
The diff coverage is n/a.

@@          Coverage Diff           @@
##           master    #178   +/-   ##
======================================
  Coverage    94.1%   94.1%           
======================================
  Files          21      21           
  Lines        1189    1189           
======================================
  Hits         1120    1120           
  Misses         69      69           

@klwetstone
Copy link
Contributor Author

@jayqi this fixes the same issue in cloudpathlib that we just fixed in zamba if you have a chance to look it over. Thanks!

Copy link
Member

@jayqi jayqi left a comment

Choose a reason for hiding this comment

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

Thanks @klwetstone! One minor change.

@klwetstone
Copy link
Contributor Author

klwetstone commented Oct 20, 2021

@jayqi updated! should be good to merge once the tests finish

Copy link
Member

@jayqi jayqi left a comment

Choose a reason for hiding this comment

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

Works like a charm. Thanks @klwetstone!

@jayqi jayqi merged commit 3901746 into master Oct 20, 2021
@jayqi jayqi deleted the mkdocs-fix branch October 20, 2021 16:02
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants