Skip to content

Commit

Permalink
Refactor API documentation (home-assistant#33217)
Browse files Browse the repository at this point in the history
* Upgrade Sphinx to 2.4.4

* Refactor API documentation

* Remove left-over

* Remove Markdown from docstring

* Update titels
  • Loading branch information
fabaff authored Mar 25, 2020
1 parent 6d311a3 commit 2647296
Show file tree
Hide file tree
Showing 17 changed files with 592 additions and 388 deletions.
29 changes: 29 additions & 0 deletions docs/source/api/auth.rst
Original file line number Diff line number Diff line change
@@ -0,0 +1,29 @@
:mod:`homeassistant.auth`
=========================

.. automodule:: homeassistant.auth
:members:

homeassistant.auth.auth\_store
------------------------------

.. automodule:: homeassistant.auth.auth_store
:members:
:undoc-members:
:show-inheritance:

homeassistant.auth.const
------------------------

.. automodule:: homeassistant.auth.const
:members:
:undoc-members:
:show-inheritance:

homeassistant.auth.models
-------------------------

.. automodule:: homeassistant.auth.models
:members:
:undoc-members:
:show-inheritance:
2 changes: 1 addition & 1 deletion docs/source/api/bootstrap.rst
Original file line number Diff line number Diff line change
@@ -1,7 +1,7 @@
.. _bootstrap_module:

:mod:`homeassistant.bootstrap`
-------------------------
------------------------------

.. automodule:: homeassistant.bootstrap
:members:
170 changes: 170 additions & 0 deletions docs/source/api/components.rst
Original file line number Diff line number Diff line change
@@ -0,0 +1,170 @@
:mod:`homeassistant.components`
===============================

air\_quality
--------------------------------------------

.. automodule:: homeassistant.components.air_quality
:members:
:undoc-members:
:show-inheritance:

alarm\_control\_panel
--------------------------------------------

.. automodule:: homeassistant.components.alarm_control_panel
:members:
:undoc-members:
:show-inheritance:

binary\_sensor
--------------------------------------------

.. automodule:: homeassistant.components.binary_sensor
:members:
:undoc-members:
:show-inheritance:

camera
---------------------------

.. automodule:: homeassistant.components.camera
:members:
:undoc-members:
:show-inheritance:

calendar
---------------------------

.. automodule:: homeassistant.components.calendar
:members:
:undoc-members:
:show-inheritance:

climate
---------------------------

.. automodule:: homeassistant.components.climate
:members:
:undoc-members:
:show-inheritance:

conversation
---------------------------

.. automodule:: homeassistant.components.conversation
:members:
:undoc-members:
:show-inheritance:

cover
---------------------------

.. automodule:: homeassistant.components.cover
:members:
:undoc-members:
:show-inheritance:

device\_tracker
---------------------------

.. automodule:: homeassistant.components.device_tracker
:members:
:undoc-members:
:show-inheritance:

fan
---------------------------

.. automodule:: homeassistant.components.fan
:members:
:undoc-members:
:show-inheritance:

light
---------------------------

.. automodule:: homeassistant.components.light
:members:
:undoc-members:
:show-inheritance:

lock
---------------------------

.. automodule:: homeassistant.components.lock
:members:
:undoc-members:
:show-inheritance:

media\_player
---------------------------

.. automodule:: homeassistant.components.media_player
:members:
:undoc-members:
:show-inheritance:

notify
---------------------------

.. automodule:: homeassistant.components.notify
:members:
:undoc-members:
:show-inheritance:

remote
---------------------------

.. automodule:: homeassistant.components.remote
:members:
:undoc-members:
:show-inheritance:

switch
---------------------------

.. automodule:: homeassistant.components.switch
:members:
:undoc-members:
:show-inheritance:

sensor
-------------------------------------

.. automodule:: homeassistant.components.sensor
:members:
:undoc-members:
:show-inheritance:

vacuum
-------------------------------------

.. automodule:: homeassistant.components.vacuum
:members:
:undoc-members:
:show-inheritance:

water\_heater
-------------------------------------

.. automodule:: homeassistant.components.water_heater
:members:
:undoc-members:
:show-inheritance:

weather
---------------------------

.. automodule:: homeassistant.components.weather
:members:
:undoc-members:
:show-inheritance:

webhook
---------------------------

.. automodule:: homeassistant.components.webhook
:members:
:undoc-members:
:show-inheritance:
7 changes: 7 additions & 0 deletions docs/source/api/config_entries.rst
Original file line number Diff line number Diff line change
@@ -0,0 +1,7 @@
.. _config_entries_module:

:mod:`homeassistant.config_entries`
-----------------------------------

.. automodule:: homeassistant.config_entries
:members:
33 changes: 1 addition & 32 deletions docs/source/api/core.rst
Original file line number Diff line number Diff line change
Expand Up @@ -4,35 +4,4 @@
-------------------------

.. automodule:: homeassistant.core

.. autoclass:: Config
:members:

.. autoclass:: Event
:members:

.. autoclass:: EventBus
:members:

.. autoclass:: HomeAssistant
:members:

.. autoclass:: State
:members:

.. autoclass:: StateMachine
:members:

.. autoclass:: ServiceCall
:members:

.. autoclass:: ServiceRegistry
:members:

Module contents
---------------

.. automodule:: homeassistant.core
:members:
:undoc-members:
:show-inheritance:
:members:
7 changes: 7 additions & 0 deletions docs/source/api/data_entry_flow.rst
Original file line number Diff line number Diff line change
@@ -0,0 +1,7 @@
.. _data_entry_flow_module:

:mod:`homeassistant.data_entry_flow`
-----------------------------

.. automodule:: homeassistant.data_entry_flow
:members:
10 changes: 0 additions & 10 deletions docs/source/api/device_tracker.rst

This file was deleted.

12 changes: 0 additions & 12 deletions docs/source/api/entity.rst

This file was deleted.

20 changes: 0 additions & 20 deletions docs/source/api/event.rst

This file was deleted.

7 changes: 7 additions & 0 deletions docs/source/api/exceptions.rst
Original file line number Diff line number Diff line change
@@ -0,0 +1,7 @@
.. _exceptions_module:

:mod:`homeassistant.exceptions`
-------------------------------

.. automodule:: homeassistant.exceptions
:members:
Loading

0 comments on commit 2647296

Please sign in to comment.