Skip to content

Conversation

@andrew-scott-fischer
Copy link
Contributor

Add an example of using io-ts-http

TICKET: BG-50225

@andrew-scott-fischer andrew-scott-fischer requested a review from a team June 24, 2022 18:49
@andrew-scott-fischer andrew-scott-fischer self-assigned this Jun 24, 2022
@vmccarty
Copy link
Contributor

Hello :)

Copy link
Contributor

@ericcrosson-bitgo ericcrosson-bitgo left a comment

Choose a reason for hiding this comment

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

Very cursory first pass, will go over the content in more depth shortly

TICKET: BG-50225

fix: format files

Update packages/io-ts-http/README.md

Co-authored-by: Vivian McCarty <107434158+vmccarty@users.noreply.github.com>

Update packages/io-ts-http/README.md

Co-authored-by: Vivian McCarty <107434158+vmccarty@users.noreply.github.com>

Update packages/io-ts-http/README.md

Co-authored-by: Vivian McCarty <107434158+vmccarty@users.noreply.github.com>

Update packages/io-ts-http/README.md

Co-authored-by: Vivian McCarty <107434158+vmccarty@users.noreply.github.com>

Update packages/io-ts-http/README.md

Co-authored-by: Vivian McCarty <107434158+vmccarty@users.noreply.github.com>

Update packages/io-ts-http/README.md

Co-authored-by: Vivian McCarty <107434158+vmccarty@users.noreply.github.com>

Update packages/io-ts-http/README.md

Co-authored-by: Vivian McCarty <107434158+vmccarty@users.noreply.github.com>

Update packages/io-ts-http/README.md

Co-authored-by: Vivian McCarty <107434158+vmccarty@users.noreply.github.com>

Update packages/io-ts-http/README.md

Co-authored-by: Vivian McCarty <107434158+vmccarty@users.noreply.github.com>

Update packages/io-ts-http/README.md

Co-authored-by: Vivian McCarty <107434158+vmccarty@users.noreply.github.com>

Update packages/io-ts-http/README.md

Co-authored-by: Vivian McCarty <107434158+vmccarty@users.noreply.github.com>

Update packages/io-ts-http/README.md

Co-authored-by: Vivian McCarty <107434158+vmccarty@users.noreply.github.com>

Update packages/io-ts-http/README.md

Co-authored-by: Vivian McCarty <107434158+vmccarty@users.noreply.github.com>

Update packages/io-ts-http/README.md

Co-authored-by: Vivian McCarty <107434158+vmccarty@users.noreply.github.com>

Update packages/io-ts-http/README.md

Co-authored-by: Vivian McCarty <107434158+vmccarty@users.noreply.github.com>

Update packages/io-ts-http/README.md

Co-authored-by: Vivian McCarty <107434158+vmccarty@users.noreply.github.com>

Update packages/io-ts-http/README.md

Co-authored-by: Vivian McCarty <107434158+vmccarty@users.noreply.github.com>

Update packages/io-ts-http/README.md

Co-authored-by: Vivian McCarty <107434158+vmccarty@users.noreply.github.com>

Update packages/io-ts-http/README.md

Co-authored-by: Vivian McCarty <107434158+vmccarty@users.noreply.github.com>

Update packages/io-ts-http/README.md

Co-authored-by: Vivian McCarty <107434158+vmccarty@users.noreply.github.com>

Update packages/io-ts-http/README.md

Co-authored-by: Vivian McCarty <107434158+vmccarty@users.noreply.github.com>

Update packages/io-ts-http/README.md

Co-authored-by: Vivian McCarty <107434158+vmccarty@users.noreply.github.com>

Update packages/io-ts-http/README.md

Co-authored-by: Vivian McCarty <107434158+vmccarty@users.noreply.github.com>

Update packages/io-ts-http/README.md

Co-authored-by: Vivian McCarty <107434158+vmccarty@users.noreply.github.com>

Update packages/io-ts-http/README.md

Co-authored-by: Eric Crosson <67922293+ericcrosson-bitgo@users.noreply.github.com>

Update packages/io-ts-http/README.md

Co-authored-by: Eric Crosson <67922293+ericcrosson-bitgo@users.noreply.github.com>

Update packages/io-ts-http/README.md

Co-authored-by: Vivian McCarty <107434158+vmccarty@users.noreply.github.com>
@andrew-scott-fischer andrew-scott-fischer force-pushed the BG-50225-mention-api-spec-on-the-io-ts-http-readme branch from 9a2a745 to a0beacf Compare June 27, 2022 20:35
Comment on lines +213 to +214
The first import is the `io-ts` package. It's usually imported `as t` for use in
describing the types of data properties. Again, review
[io-ts](https://github.com/gcanti/io-ts) documentation for more context on how to use it
and this package.
Copy link
Contributor

@ericcrosson-bitgo ericcrosson-bitgo Jun 28, 2022

Choose a reason for hiding this comment

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

I waffle on whether or not we can consider this assumed knowledge of our audience. I suppose we'd best not consider it base knowledge.

Where did we first reference the io-ts readme? (Referencing the word Again,)

Suggested change
The first import is the `io-ts` package. It's usually imported `as t` for use in
describing the types of data properties. Again, review
[io-ts](https://github.com/gcanti/io-ts) documentation for more context on how to use it
and this package.
The first import is the `io-ts` package, which provides the foundation for arbitrary-precision in defining api-ts specifications. Review
[the io-ts documentation](https://github.com/gcanti/io-ts/blob/master/index.md) to learn more.

Copy link
Contributor

Choose a reason for hiding this comment

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

The Preface mentions io-ts and provides a link to the docs for it.

@andrew-scott-fischer andrew-scott-fischer force-pushed the BG-50225-mention-api-spec-on-the-io-ts-http-readme branch from 828709f to bcff264 Compare June 28, 2022 23:11
docs: make intro more clear

Co-authored-by: Eric Crosson <67922293+ericcrosson-bitgo@users.noreply.github.com>

docs: describe more clearly what io-ts-http is used for

Co-authored-by: Eric Crosson <67922293+ericcrosson-bitgo@users.noreply.github.com>
@andrew-scott-fischer andrew-scott-fischer force-pushed the BG-50225-mention-api-spec-on-the-io-ts-http-readme branch from bcff264 to 5ef623d Compare June 28, 2022 23:11
@bitgopatmcl bitgopatmcl merged commit 2c1e390 into BitGo:beta Jun 30, 2022
@github-actions
Copy link

🎉 This PR is included in version 1.0.0-beta.15 🎉

The release is available on npm package (@beta dist-tag)

Your semantic-release bot 📦🚀

@github-actions
Copy link

🎉 This PR is included in version 0.2.0-beta.7 🎉

The release is available on npm package (@beta dist-tag)

Your semantic-release bot 📦🚀

@github-actions
Copy link

🎉 This PR is included in version 0.2.0-beta.4 🎉

The release is available on npm package (@beta dist-tag)

Your semantic-release bot 📦🚀

@github-actions
Copy link

🎉 This PR is included in version 0.2.0-beta.10 🎉

The release is available on npm package (@beta dist-tag)

Your semantic-release bot 📦🚀

@ericcrosson-bitgo
Copy link
Contributor

This PR landed! 🥳 🎉 Well done @andrew-scott-fischer and team!

This is a major step forward, thanks for all the effort behind this milestone 🚀

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.

4 participants