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

Canonical SDK feature list #142

Merged
merged 140 commits into from
Jun 15, 2022
Merged

Canonical SDK feature list #142

merged 140 commits into from
Jun 15, 2022

Conversation

QuintinWillison
Copy link
Contributor

@QuintinWillison QuintinWillison commented Mar 25, 2022

Opus. Early days on this pull request, which I expect to stay in a Draft state for a few days while I work on getting it ready for reviewers. In the meantime, I'm pushing the work up for visibility as I know various people are interested in how this work is evolving.

I expect that I will feel this pull request is ready when the following have been completed:

  • features/README.md populated, including descriptions of:
    • what this is and why it's been created
    • how it's used downstream, or at least how it's anticipated to be used
    • how it intersects with versioning - mentioning client library spec., protocol and SDKs
  • features/ephemeral-notes.md removed
  • Uploads the feature list in human-readable format (likely HTML) to sdk.ably.com, in order to allow us to manual inspect it
  • Illustrates the downstream format anticipated to be used by SDK repositories to indicate which features from this list they implement
  • Worked out whether/how to include the client library spec. and/or protocol version... I feel that the protocol supported by an SDK is a feature

@QuintinWillison QuintinWillison self-assigned this Mar 25, 2022
…file.

By adding the yaml extension to the prettier tool's remit I had started looping in this file, albeit not on macOS runners (explaining why it was failing in our Linux-based CI runner but not locally for me, macOS-based).
The file .markdownlint-cli2.yaml was being overlooked on macOS because of its dot prefix, despite failing our Linux-based CI.

For what it's worth, I first tried a "more clever" pattern but that caused a different failure:

ably-common % npm run lint

> ably-common@1.2.0 lint
> npm-run-all format:*:check

> ably-common@1.2.0 format:js-code:check
> eslint --max-warnings=0 .

> ably-common@1.2.0 format:data:check
> prettier --check **/{.*,*}.{json,yml,yaml}

Checking formatting...
[error] No files matching the pattern were found: "**/.*.yml".
All matched files use Prettier code style!
ERROR: "format:data:check" exited with 2.
?1
Base automatically changed from eslint to main March 29, 2022 11:37
@github-actions github-actions bot temporarily deployed to staging/pull/142/sdk-features March 30, 2022 13:03 Inactive
@github-actions github-actions bot temporarily deployed to staging/pull/142/sdk-features March 30, 2022 13:34 Inactive
@github-actions github-actions bot temporarily deployed to staging/pull/142/sdk-features March 30, 2022 13:49 Inactive
@github-actions github-actions bot temporarily deployed to staging/pull/142/sdk-features March 31, 2022 18:23 Inactive
@github-actions github-actions bot temporarily deployed to staging/pull/142/sdk-features April 12, 2022 12:28 Inactive
@QuintinWillison
Copy link
Contributor Author

I'm back from some time off and am now going to re-assign this pull request to myself. @owenpearson and I have discussed the content and have agreed that the ephemeral notes markdown file should be removed, as it's not appropriate for addition to the Git index. If there are any parts of that file which I feel need to outlive this PR then I shall put them in a GitHub issue.

@github-actions github-actions bot temporarily deployed to staging/pull/142/sdk-features June 14, 2022 08:47 Inactive
Copy link
Contributor

@tomkirbygreen tomkirbygreen left a comment

Choose a reason for hiding this comment

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

First pass. Will take a more architectural look once I've attended to some other stuff.

features/README.md Outdated Show resolved Hide resolved
features/sdk-node-properties.js Show resolved Hide resolved
@QuintinWillison
Copy link
Contributor Author

Thank you to everybody who has provided review input and/or approved this work. I'm going to merge it to main branch now, however I am (as ever) always happy to receive posthumous comments as this merely establishes some foundations, so all input no matter how late received is very welcome - there's plenty more work to be done.

@QuintinWillison QuintinWillison merged commit 199b561 into main Jun 15, 2022
@QuintinWillison QuintinWillison deleted the sdk-features branch June 15, 2022 15:30
Copy link
Member

@lmars lmars left a comment

Choose a reason for hiding this comment

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

I had a pending review that I forgot to submit, sorry! Only minor though...

- uses: ably/sdk-upload-action@v1
with:
s3AccessKeyId: ${{ secrets.SDK_S3_ACCESS_KEY_ID }}
s3AccessKey: ${{ secrets.SDK_S3_ACCESS_KEY }}
Copy link
Member

Choose a reason for hiding this comment

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

This should use GitHub OIDC.

Copy link
Contributor Author

Choose a reason for hiding this comment

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

Thanks. I've created #154

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

Successfully merging this pull request may close these issues.

8 participants