Fix broken links in CONTRIBUTING.rst

* turn on apidocs option for individual module docs
* crosslink to information using :doc: and :ref:

Change-Id: Ie8016623251fb0f55335c64252060d4ce966dc96
This commit is contained in:
Cenne 2021-07-01 14:23:36 +02:00
parent 948325cae7
commit 072ebdc1f1
2 changed files with 14 additions and 15 deletions

View File

@ -177,8 +177,8 @@ Writing a Plugin
* **ironic-inspector** allows you to hook code into the data processing chain * **ironic-inspector** allows you to hook code into the data processing chain
after introspection. Inherit ``ProcessingHook`` class defined in after introspection. Inherit ``ProcessingHook`` class defined in
ironic_inspector.plugins.base_ module and overwrite any or both of :doc:`/contributor/api/ironic_inspector.plugins.base` and overwrite any or
the following methods: both of the following methods:
``before_processing(introspection_data,**)`` ``before_processing(introspection_data,**)``
called before any data processing, providing the raw data. Each plugin in called before any data processing, providing the raw data. Each plugin in
@ -211,9 +211,10 @@ Writing a Plugin
configuration file (``processing.node_not_found_hook`` option). configuration file (``processing.node_not_found_hook`` option).
* **ironic-inspector** allows more condition types to be added for * **ironic-inspector** allows more condition types to be added for
`Introspection Rules`_. Inherit ``RuleConditionPlugin`` class defined in :ref:`Introspection Rules <introspection_rules>`.
ironic_inspector.plugins.base_ module and overwrite at least the following Inherit ``RuleConditionPlugin`` class defined in
method: :doc:`/contributor/api/ironic_inspector.plugins.base` and overwrite at least
the following method:
``check(node_info,field,params,**)`` ``check(node_info,field,params,**)``
called to check that condition holds for a given field. Field value is called to check that condition holds for a given field. Field value is
@ -238,10 +239,11 @@ Writing a Plugin
Make your plugin a setuptools entry point under Make your plugin a setuptools entry point under
``ironic_inspector.rules.conditions`` namespace. ``ironic_inspector.rules.conditions`` namespace.
* **ironic-inspector** allows more action types to be added for `Introspection * **ironic-inspector** allows more action types to be added for
Rules`_. Inherit ``RuleActionPlugin`` class defined in :ref:`Introspection Rules <introspection_rules>`.
ironic_inspector.plugins.base_ module and overwrite at least the following Inherit ``RuleActionPlugin`` class defined in
method: :doc:`/contributor/api/ironic_inspector.plugins.base` and overwrite at least
the following method:
``apply(node_info,params,**)`` ``apply(node_info,params,**)``
called to apply the action. called to apply the action.
@ -264,15 +266,12 @@ Writing a Plugin
``**`` argument is needed so that we can add optional arguments without ``**`` argument is needed so that we can add optional arguments without
breaking out-of-tree plugins. Please make sure to include and ignore it. breaking out-of-tree plugins. Please make sure to include and ignore it.
.. _ironic_inspector.plugins.base: https://docs.openstack.org/ironic-inspector/latest/contributor/api/ironic_inspector.plugins.base.html
.. _Introspection Rules: https://docs.openstack.org/ironic-inspector/latest/user/usage.html#introspection-rules
Making changes to the database Making changes to the database
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
In order to make a change to the ironic-inspector database you must update the In order to make a change to the ironic-inspector database you must update the
database models found in ironic_inspector.db_ and then create a migration to database models found in :doc:`/contributor/api/ironic_inspector.db` and then
reflect that change. create a migration to reflect that change.
There are two ways to create a migration which are described below, both of There are two ways to create a migration which are described below, both of
these generate a new migration file. In this file there is only one function: these generate a new migration file. In this file there is only one function:
@ -311,7 +310,6 @@ the database::
ironic-inspector-dbsync revision -m "A short description" ironic-inspector-dbsync revision -m "A short description"
.. _Create a Migration Script: http://alembic.zzzcomputing.com/en/latest/tutorial.html#create-a-migration-script .. _Create a Migration Script: http://alembic.zzzcomputing.com/en/latest/tutorial.html#create-a-migration-script
.. _ironic_inspector.db: https://docs.openstack.org/ironic-inspector/latest/contributor/api/ironic_inspector.db.html
.. _What does Autogenerate Detect (and what does it not detect?): http://alembic.zzzcomputing.com/en/latest/autogenerate.html#what-does-autogenerate-detect-and-what-does-it-not-detect .. _What does Autogenerate Detect (and what does it not detect?): http://alembic.zzzcomputing.com/en/latest/autogenerate.html#what-does-autogenerate-detect-and-what-does-it-not-detect
Implementing PXE Filter Drivers Implementing PXE Filter Drivers

View File

@ -131,3 +131,4 @@ apidoc_excluded_paths = [
'test', 'test',
'common/i18n*' 'common/i18n*'
] ]
apidoc_separate_modules = True