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

Docs review feedback #22

Open
1 of 7 tasks
cmsirbu opened this issue Mar 15, 2023 · 0 comments
Open
1 of 7 tasks

Docs review feedback #22

cmsirbu opened this issue Mar 15, 2023 · 0 comments
Milestone

Comments

@cmsirbu
Copy link
Contributor

cmsirbu commented Mar 15, 2023

The current README provides a good baseline. I'd like us to investigate some of the extras listed below within the context of how all other Nautobot project documentation is presented (via docs.nautobot.com).

Open questions:

  • I assume the invoke part (python dependency) is required only for development? Since the project straddles two languages because of Nautobot, it's probably OK. But there is no guidance provided for its usage (consider a go dev coming here with no python knowledge).
  • Have you considered building a docs site using mkdocs? Since we're using some python tooling that could be fine to augment the automatic godoc stuff that will be generated by google.

Working from the following checklist:

  • Reviewed docs: 📝 Improve repo readme #21 with comments - CS
  • Test Customization instructions from scratch - CS
  • Test howto main example - CS
  • Investigate hosting a docs site based on the nautobot standard docs
  • Investigate godoc output (possibly markdown files we could host/integrate with mkdocs?)
@chadell chadell added this to the v1.5.0-beta milestone Mar 20, 2023
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

No branches or pull requests

2 participants