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

Feedback on Profile document #280

Closed
danielpeintner opened this issue Sep 14, 2022 · 1 comment
Closed

Feedback on Profile document #280

danielpeintner opened this issue Sep 14, 2022 · 1 comment

Comments

@danielpeintner
Copy link
Contributor

(based on https://pr-preview.s3.amazonaws.com/w3c/wot-profile/pull/272.html)

General

Different spellings across the document: PlugFests, Plugfests, ..

Typos

see #279

Abstract

see https://pr-preview.s3.amazonaws.com/w3c/wot-profile/pull/272.html#abstract

There is the following statement

The HTTP Baseline Profile formalizes the results of several PlugFests that were conducted by the WoT Interest Group and of tests that were conducted as part of the development.

This is simply not true and I suggest to reword/remove this statement.

3.1 Additional Definitions

see https://pr-preview.s3.amazonaws.com/w3c/wot-profile/pull/272.html#additional-definitions-

Baseline Profile vs. HTTP Baseline Profile
Personally... I would stick to use one term. Using "Baseline Profile" may raise other expectations. Hence "HTTP Baseline Profile" seems to be the term to go with.

7.2.2 Actions

see https://pr-preview.s3.amazonaws.com/w3c/wot-profile/pull/272.html#http-baseline-profile-protocol-binding-actions

There is #266 from @benfrancis.
What are the expectations here?

@mlagally
Copy link
Contributor

mlagally commented Oct 28, 2022

There is the following statement

The HTTP Baseline Profile formalizes the results of several PlugFests that were conducted by the WoT Interest Group and of tests that were conducted as part of the development.

This is simply not true and I suggest to reword/remove this statement.

This has been true when the first draft of the profile spec was written.

It will become true again, when we have conducted the next plugfest, assuming we get enough participants.
In the meantime, please understand that we just keep the inaccurate text.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Projects
None yet
Development

No branches or pull requests

2 participants