-
Notifications
You must be signed in to change notification settings - Fork 0
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
Bootstrap lambkin-shepherd
documentation
#48
Conversation
Signed-off-by: Michel Hidalgo <[email protected]>
Also, @francocipollone PTAL. |
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 job! Tried it locally and works as a charm.
|
||
```sh | ||
cd docs | ||
make html |
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.
Not needed to run this within the shell?
poetry run make html
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.
poetry run
is already used within the Makefile.
@@ -0,0 +1,413 @@ | |||
import contextlib |
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.
missing license?
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.
Good catch. Fixed in 2f8554c.
Signed-off-by: Michel Hidalgo <[email protected]>
Moving forward. |
Proposed changes
This patch sets up
lambkin-shepherd
documentation usingsphinx
. That's easier said than done, as RobotFramework tooling for documentation is... bad, let's stay with bad. Thisautorobot
Sphinx extension is what I came up with to address that. I was planning to polish the package documentation before submitting this PR, but let's review this first.Connected to #18 and #44.
Type of change
Checklist
Additional comments
This patch is lacking linters for ReST documents. That will come later, with the rest of the documentation. Also, I did not add any tests for the
autorobot
extension. I don't think it's worth it.