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

Clean up adapter documentation #208

Merged
merged 4 commits into from
Mar 1, 2017
Merged

Conversation

MichaelWedel
Copy link
Contributor

After moving adapters to core.adapters, we forgot to also modify the documentation. This fixes the documentation, plus the core APIs are now alphabetically ordered which is easier to scan through.

After moving adapters to `core.adapters`, we forgot to also
modify the documentation. This fixes the documentation, plus
the core APIs are now alphabetically ordered which is easier
to scan through.
@MichaelWedel MichaelWedel force-pushed the add_core_adapter_documentation branch from 7600ebf to 8afe97e Compare March 1, 2017 09:21
@@ -18,7 +18,7 @@
# *********************************************************************

"""
The core Adapter API is located in :mod:`lewis.core.adapters`. This module on the contains
The core Adapter API is located in :mod:`lewis.core.adapters`. This package on the contains
Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

👍

Copy link
Contributor

@MikeHart85 MikeHart85 left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Just the one comment about dashes. Not sure if you agree?

I also went ahead and changed "module" to "package" in adapters/__init__.py.


.. toctree::
:maxdepth: 2

adapters/adapters
adapters/epics
adapters/modbus
adapters/stream
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

The titles this generates (based on the rst files in docs/api/adapters/) are:

    The EPICS-Adapter
    The Modbus Adapter
    The Stream-Adapter

The dashes are inconsistent. I think no dash makes more sense?

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Yes, seems better without dashes at all, while we're at it.

@MikeHart85 MikeHart85 merged commit a2bcd77 into master Mar 1, 2017
@MikeHart85 MikeHart85 deleted the add_core_adapter_documentation branch March 1, 2017 11:05
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Projects
None yet
Development

Successfully merging this pull request may close these issues.

None yet

2 participants