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

871 clarify channels behaviour and fix a markdown issue in API spec #971

Merged
merged 11 commits into from
May 23, 2023

Conversation

kriswest
Copy link
Contributor

resolves #871

  • Adds an additional clarifying note on user/app channel behaviour differences.

  • Corrects a few spelling errors in API spec and Americanizes some spellings 🤢

  • Fixes a markdown rendering issue in the Desktop Agent specification I encountered while editing:

    image

    image

@kriswest kriswest added bug Something isn't working docs Documentation api FDC3 API Working Group labels Apr 28, 2023
@kriswest kriswest requested review from hughtroeger and a team April 28, 2023 12:19
@netlify
Copy link

netlify bot commented Apr 28, 2023

Deploy Preview for fdc3 canceled.

Name Link
🔨 Latest commit e6b6a0c
🔍 Latest deploy log https://app.netlify.com/sites/fdc3/deploys/646c98007d51ac0008ef5fe4

Copy link
Contributor

@hughtroeger hughtroeger left a comment

Choose a reason for hiding this comment

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

Looks good!

website/versioned_docs/version-2.0/api/ref/Channel.md Outdated Show resolved Hide resolved
@hughtroeger
Copy link
Contributor

Actually, this PR doesn't include changes to the 1.2 docs, which is mentioned in the issue and I know we had discussed. Do we still want to include those updates? I'm happy to make those changes and update this branch.

@kriswest
Copy link
Contributor Author

kriswest commented May 9, 2023

@greyseer256 If you're up for making the 1.2 changes, please go for it. No need to touch the /src/api/* file comments however, unless we want to release an npm module version with updated comments and a 1.2.x version number. The website's documentation is more accessible however.

Co-authored-by: Hugh Troeger <htroeger@factset.com>
Copy link
Contributor

@mistryvinay mistryvinay left a comment

Choose a reason for hiding this comment

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

LGTM

@kriswest
Copy link
Contributor Author

@greyseer256 on reflection, I'm not that worried about 1.2 docs. Still happy for the addition to go there too, but I think people will mostly read the current version of the documentation (and NPM module with comments).

@hughtroeger
Copy link
Contributor

@kriswest sorry it took me so long, I just filed a PR (into this branch) applying the same language to the 1.2 version of the docs:
#995

docs(1.2): clarify language about channel joining behavior
docs/api/spec.md Outdated Show resolved Hide resolved
CHANGELOG.md Outdated Show resolved Hide resolved
@kriswest kriswest merged commit 467f616 into master May 23, 2023
@kriswest kriswest deleted the 871-clarify-channels-behaviour branch May 23, 2023 11:01
@kriswest kriswest mentioned this pull request May 25, 2023
27 tasks
@bingenito bingenito mentioned this pull request Nov 6, 2023
18 tasks
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
api FDC3 API Working Group bug Something isn't working docs Documentation
Projects
None yet
Development

Successfully merging this pull request may close these issues.

Clarify differences between App and User Channel behaviour (in docs for FDC3 versions 1.1, 1.2, 2.0 and next)
3 participants