Skip to content

Commit 46edd27

Browse files
Merge pull request #658 from bytecodealliance/docs-08-13
sig-docs 08-13-2025 notes
2 parents 5692867 + 0925b5b commit 46edd27

1 file changed

Lines changed: 29 additions & 3 deletions

File tree

SIG-Documentation/2025/docs-08-13.md

Lines changed: 29 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -12,12 +12,38 @@
1212

1313
## Attendees
1414

15-
* TODO
15+
* Tim Chevalier
16+
* Kate Goldenring
17+
* Mikhail Katychev
18+
* Danny Macovei
19+
* Victor Adossi
1620

1721
## Notes
1822

19-
* TODO
23+
* Tim Revised 3rd and 4th sections of the component model book and the c# section. Planning to go through the rest of the book as well.
24+
* Tim: Still work to do around examples
25+
* Danny: Some of the recent refactoring could make using the WIT in a registry work. We need to just make sure the cargo component instructions are updated. Danny anticipates having more time to update it in the next week or two
26+
* Mikhail: Any changes for that that needs to be done in wkg?
27+
* Danny: No changes. But WAC can still only use warg
28+
* Victor: Merged changes to C quide
29+
* Mikhail: Had a coworker get confused between the difference between a target dependency and a dependency
30+
* Danny: People who like cargo component, like that it takes on more stuff than the p2 target. Cargo component doesn't have people who are regularly adding features so this may be the best place to socialize issues
31+
* Mikhail: Where should this be explained?
32+
* Kate: I think it should live closer to the source so in the cargo component repo
33+
* Victor: I think it should live in both places -- cargo component docs and component book.
34+
* Danny: We should talk to Alex and Pat about the future they see for cargo component. Right now, if you want to build a component from a wit package in a registry, it lets you do so without using wkg.
35+
* Victor: As long as we have cargo component as the thing as we use, we should represent footguns early. The guide should be simple and breezy -- a good intro to wasm.
36+
* Kate: Sounds like we should have "keep it simple and breezy and a good intro to components" as a north star. Documenting in both places SGTM. There has been a lot of uncertainty of how much to commit to cargo component given it's maintenance status. P3 is coming soon too. Maybe we invite Alex or Pat to our next meeting to get their thoughts on the future of documenting developing components with Rust.
37+
* Victor: Can we set up analytics
38+
* Kate: We have analytics on Plausible. Kate pinged David to get information on how to access the data: https://github.com/bytecodealliance/component-docs/issues/157
39+
* Victor: Should we put examples in the repo? Seems like we should if it is a guide. We should test those files with commits to component docs
40+
* Kate: We haven't made progress moving the examples to their own repos so keeping it in repo where there is less barriers and keeping the code tested SGTM.
41+
* Victor: Should we add Pat as a reviewer to the component docs repo?
42+
* Kate: Since he has been doing regular reviews, it seems like a normal progression to elevate him if we wants\
43+
* Mikhail: Update on syntax highlighting
2044

2145
## Action Items
2246

23-
* [ ] TODO
47+
* [ ] Victor: Reach out to Pat about becoming a reviewer
48+
* [ ] Kate: Reach out to Alex about presenting about "future of component docs / rust docs for p3"
49+
* [ ] Kate: Upload previous youtube video from when OOF

0 commit comments

Comments
 (0)