[Checkins] [zopefoundation/zope.interface] 771721: Documentation clarifications.

[Jason Madden]

  Branch: refs/heads/master
  Home:   https://github.com/zopefoundation/zope.interface
  Commit: 771721fccf4c88c798f850d7830af6448aca2232
      https://github.com/zopefoundation/zope.interface/commit/771721fccf4c88c798f850d7830af6448aca2232
  Author: Jason Madden <jamadden at gmail.com>
  Date:   2020-03-17 (Tue, 17 Mar 2020)

  Changed paths:
    M docs/adapter.rst
    M src/zope/interface/interfaces.py

  Log Message:
  -----------
  Documentation clarifications.

- docs/adapter.rst
  Subscriptions are returned from least to most specific, not the other way around; the docs were incorrect.

  Add additional examples, and use more verbose names in current examples, to clarify this. Fixes #136.
- interfaces.py
  names() and namesAndDescriptions() just return a collection, not a sequence. Fixes #134.


  Commit: bd5a749b5b050b422940193d8d2935e7c88aa7cc
      https://github.com/zopefoundation/zope.interface/commit/bd5a749b5b050b422940193d8d2935e7c88aa7cc
  Author: Jason Madden <jamadden at gmail.com>
  Date:   2020-03-18 (Wed, 18 Mar 2020)

  Changed paths:
    M docs/adapter.rst
    M src/zope/interface/interfaces.py

  Log Message:
  -----------
  Merge pull request #189 from zopefoundation/issue136-issue134

Documentation clarifications.


Compare: https://github.com/zopefoundation/zope.interface/compare/0f80d05343b5...bd5a749b5b05