Skip to content

readme updates#1230

Open
davidzhao wants to merge 1 commit into
mainfrom
dz/update-readme
Open

readme updates#1230
davidzhao wants to merge 1 commit into
mainfrom
dz/update-readme

Conversation

@davidzhao

Copy link
Copy Markdown
Member

will merge after api release

will merge after api release
@davidzhao davidzhao requested a review from ladvoc as a code owner July 8, 2026 23:33
@davidzhao davidzhao added the internal to tag changes that don't require changelog documentation label Jul 8, 2026

@devin-ai-integration devin-ai-integration Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

Devin Review found 2 potential issues.

Open in Devin Review

Comment thread livekit-api/README.md
Comment on lines 2 to +5

The official server API crate for [LiveKit](https://livekit.com).

Use this crate to generate access tokens and invoke LiveKit server APIs for agent dispatch, ingress, egress, SIP, and more.
Use this crate to generate access tokens and invoke LiveKit server APIs for rooms, egress, ingress, SIP, agent dispatch, and more.

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

🟡 Missing changeset file required by repository rules

No changeset file was added for this PR (livekit-api/README.md change), violating the repository's mandatory changeset requirement.

Impact: The PR cannot be properly tracked for release notes and version bumping.

Changeset requirement from AGENTS.md

AGENTS.md states: "Every PR needs a changeset" and "Changeset must list any crates which need to be bumped stemming from the change." Since the README is referenced in livekit-api/Cargo.toml:8 via readme = "README.md", it is part of the published crate and a changeset documenting at least a patch bump for livekit-api should be included. Changesets are created via knope document-change or manually in /.changeset.

(Refers to lines 1-5)

Open in Devin Review

Was this helpful? React with 👍 or 👎 to provide feedback.

Comment thread livekit-api/README.md
Comment on lines +95 to +105
.create_sip_participant(
"ST_trunk".to_owned(),
"+15105550100".to_owned(),
"my-room".to_owned(),
CreateSIPParticipantOptions {
wait_until_answered: Some(true),
..Default::default()
},
None,
)
.await;

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

🔍 SIP example function takes owned String parameters rather than &str

The create_sip_participant example at livekit-api/README.md:95-104 passes .to_owned() strings because the actual function signature at livekit-api/src/services/sip.rs:650-656 takes String parameters (not &str). AGENTS.md recommends "Functions should generally accept &str/&[T] rather than String/Vec<T>". This is a pre-existing API design concern (not introduced by this README PR), but worth noting if the SIP client API is ever revised — switching to &str / impl Into<String> would make the API more ergonomic and consistent with other service methods like RoomClient::create_room and RoomClient::delete_room which already accept &str.

Open in Devin Review

Was this helpful? React with 👍 or 👎 to provide feedback.

@ladvoc ladvoc left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

LGTM ✅

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

Labels

internal to tag changes that don't require changelog documentation

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants