nautobot / pylint-nautobot

Custom Pylint Rules for Nautobot
https://docs.nautobot.com/projects/pylint-nautobot/en/latest/
Other
4 stars 0 forks source link

FR: Documentation should include a Rules page for easy reference #86

Open cmsirbu opened 1 month ago

cmsirbu commented 1 month ago

Proposed Functionality

pylint-nautobot docs should have a page with a table that lists all the messages added by the plugin. All the needed info is in the checker classes.

This info can be generated automatically from code and should be inserted into the docs tree. Rule ids, nautobot version compatibility, rule descriptions are a good starting point.

Use Case

As a developer using pylint-nautobot in my project, I'd like to have an easier way of cross-referencing the output of pylint with the rule descriptions and guidance.

cmsirbu commented 1 month ago

82 has a working example that needs a bit more work and perhaps layout improvements in the rendered docs.