mongo-thingy icon indicating copy to clipboard operation
mongo-thingy copied to clipboard

Feature/mkdocs

Open abhishekpcnair opened this issue 4 months ago • 4 comments

#49 Ported from sphinx to mkdocs material theme

abhishekpcnair avatar Feb 09 '24 21:02 abhishekpcnair

Hey, thanks for your work! Is the result visible somewhere?

One important thing: we shouldn't have the mkdocs output (minified files and such) in the repository. Instead we should use a GitHub action and push that output in a branch.

You can have a look here at how we've done it for notion-sdk-py, specifically the .github/workflows/docs.yml file: https://github.com/ramnes/notion-sdk-py/pull/30

ramnes avatar Feb 10 '24 08:02 ramnes

Noted I will fix them, but the docs with sphinx right now is hosted in readthedocs right? If so, then something like this should work https://about.readthedocs.com/tools/mkdocs/

abhishekpcnair avatar Feb 10 '24 15:02 abhishekpcnair

Not very familiar with the GH, but after some trial and error, here it is https://abhishekpcnair.github.io/mongo-thingy/

The order of sections need some work though, but this could be a good starting point

abhishekpcnair avatar Feb 10 '24 16:02 abhishekpcnair

Coverage Status

coverage: 100.0%. remained the same when pulling 176c97b4ea2d6634747b08ee4357b7bdc352563d on abhishekpcnair:feature/mkdocs into 879fd7cf7437c63d7bc1e7e37e4dcf0cdf7ac882 on Refty:master.

coveralls avatar Feb 28 '24 17:02 coveralls