-
Notifications
You must be signed in to change notification settings - Fork 6
Try docusaurus for docs #33
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
Conversation
robotrapta
left a comment
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Great!
| @@ -0,0 +1,47 @@ | |||
| name: docs | |||
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
| name: docs | |
| name: docs | |
| # Builds the documentation website and publishes it to https://groundlight.github.io |
As we rely more on GHA, we should get in the habit of writing docstrings at the top for what they do.
| This website is built using [Docusaurus 2](https://docusaurus.io/), a modern static website generator. | ||
|
|
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Of course we'll want to update all this sample stuff.
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
I don't want to have a "blog" right now. We should build a place to put blog-like articles, but I don't want them to be presented that way.
tyler-romero
left a comment
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
LGTM! I like that we can just write markdown to create docs.
Check it out here: https://groundlight.github.io/python-sdk/docs/getting-started
We now have a github action that will build and deploy the site to github pages. We can change the URL to something like
docs.groundlight.aiwhen we're ready. And maybe host it on Netlify or Vercel.