Skip to content

Clarify more concisely how concepts relate to each other #64

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

Open
wants to merge 1 commit into
base: main
Choose a base branch
from

Conversation

itowlson
Copy link
Collaborator

@itowlson itowlson commented Sep 8, 2023

Fixes #59.

Copy link
Collaborator

@kate-goldenring kate-goldenring left a comment

Choose a reason for hiding this comment

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

At first glance, i thought this acted almost as a table of contents; however, as it references non-design pages, this should maybe live elsewhere

@rylev
Copy link
Collaborator

rylev commented Mar 18, 2024

@itowlson @kate-goldenring should this be rebased/merged or closed?

@kate-goldenring
Copy link
Collaborator

I think we should still add this in as a TOC for the design section. This needs to be rebased, filenames updated, and this added to summary.md such that it is the top level for the "Understanding the Component Model" section

@kate-goldenring
Copy link
Collaborator

@itowlson can we revisit this and see if we can fit in this glossary? It is a great overview for someone who is learning what WASI, WIT and the component model are. I think the package, world, and interface definitions are already covered in the WIT explainer but having a TLDR of them somewhere (maybe the top of the WIT document) could be helpful.

@kate-goldenring
Copy link
Collaborator

@itowlson what are your thoughts on moving this to the Introduction page (almost as a preface to help readers know where to go with these new terms in their lexicon)?

@itowlson
Copy link
Collaborator Author

itowlson commented Apr 9, 2025

@kate-goldenring I feel like it might be overwhelming in the intro - create the feeling of "you have to know these before you can read the book" possibly. I am no longer quite sure where it would go though. It could possibly be kludged in on the "why the component model" page, even though it's more "what" than why, perhaps?

@kate-goldenring
Copy link
Collaborator

Maybe this should go under the Reference section under a new definitions page?

@ericgregory
Copy link

This is a great addition--I think the introduction is the right place for this, since these terms are ultimately critical vocabulary for understanding what follows.

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

Successfully merging this pull request may close these issues.

Differences and relation between component, WASI and WIT
4 participants