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

Producer definition #669

Merged
merged 1 commit into from Mar 31, 2022
Merged

Producer definition #669

merged 1 commit into from Mar 31, 2022

Conversation

sebastiankb
Copy link
Contributor

@sebastiankb sebastiankb commented Dec 23, 2021

fixes #656

Producer definition for terminology section


Preview | Diff

Producer definition for terminology section
@mlagally
Copy link
Contributor

@sebastiankb
"... for a specific Thing" sounds like a limitation and I think it is more generic.

Suggest "for a specific Thing or multiple Things" or to just remove that part of the definition.

@mlagally mlagally self-requested a review January 14, 2022 15:51
<dfn>Producer</dfn>
</dt>
<dd>An entity that can create WoT Thing Descriptions
for a specific Thing.</dd>
Copy link
Contributor

Choose a reason for hiding this comment

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

Is this a limitation?

Copy link
Contributor

Choose a reason for hiding this comment

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

This exactly corresponds to the term "Generator" that I proposed in my comment. I'm ok with "Producer" under this specific definition, however. As long as we are clear that "Exposer != Provider != Producer", since these might all be separate entities.

@egekorkan
Copy link
Contributor

"... for a specific Thing" sounds like a limitation and I think it is more generic.

Well, a Producer can write multiple TDs but a TD is for a single Thing. But there is an extra s there I think.

@mlagally
Copy link
Contributor

Arch call on Jan 27th:

Other specifications use "Exposer", relationship should be defined. Please seek alignment.
Exposer does not imply generating a TD.
"TD Producer" could be used to make it more unambiguous
A directory service is a producer, however the current text talks about "a thing" which could be read as a limitation.

@benfrancis
Copy link
Member

This definition looks OK to me, but how about simply "An entity which generates WoT Thing Descriptions."

It would simpler if there were just two roles:

  • Producer - Generates and exposes the metadata and interfaces of a Thing
  • Consumer - Processes and interacts with the metadata and interfaces of a Thing

The reality seems to be more complex, and the roles can be broken down as (paraphrasing):

  • Thing - An abstraction of a physical device whose capabilities and interfaces are described by a Thing Description
  • Thing Description - Describes the capabilities and interfaces of a Thing
  • Producer - Produces Thing Descriptions for one or more Things
  • Exposer - Exposes Thing Descriptions for one or more Things
  • Consumer - Processes Thing Descriptions and interacts with Things

@mlagally mlagally merged commit e30d299 into main Mar 31, 2022
@mlagally mlagally deleted the sebastiankb-patch-5 branch April 7, 2022 05:48
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.

Producer is missing in terminology section
5 participants