Skip to content

[PM-33733] Reorganize SDK documentation#793

Merged
Hinton merged 11 commits intomainfrom
sdk-docs
Apr 14, 2026
Merged

[PM-33733] Reorganize SDK documentation#793
Hinton merged 11 commits intomainfrom
sdk-docs

Conversation

@Hinton
Copy link
Copy Markdown
Member

@Hinton Hinton commented Apr 10, 2026

🎟️ Tracking

https://bitwarden.atlassian.net/browse/PM-33733

📔 Objective

Refresh of the SDK architecture documentation. Reorganizing it into new sections and expands identified gaps.

📸 Screenshots

@cloudflare-workers-and-pages
Copy link
Copy Markdown

cloudflare-workers-and-pages Bot commented Apr 10, 2026

Deploying contributing-docs with  Cloudflare Pages  Cloudflare Pages

Latest commit: c369611
Status: ✅  Deploy successful!
Preview URL: https://5e4afa91.contributing-docs.pages.dev
Branch Preview URL: https://sdk-docs.contributing-docs.pages.dev

View logs

@github-actions
Copy link
Copy Markdown
Contributor

github-actions Bot commented Apr 10, 2026

Logo
Checkmarx One – Scan Summary & Detailsd9cc5ad2-e300-41d5-99c5-fe8e042409a2

Great job! No new security vulnerabilities introduced in this pull request

@Hinton Hinton requested review from coroiu and dani-garcia April 10, 2026 14:32
@Hinton Hinton marked this pull request as ready for review April 10, 2026 14:32
@Hinton Hinton requested review from a team as code owners April 10, 2026 14:32
Copy link
Copy Markdown
Member Author

Choose a reason for hiding this comment

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

I wonder if we could make a template using https://crates.io/crates/cargo-generate to streamline this process. Have two templates, one for feature crates and another for util crates.

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

I've had good luck letting claude do it in the past, but I agree a utility that would create the crate structure, manifest and properly configured client would be nice

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.

A new Claude skill to add to the ai-plugins marketplace perhaps 🤔

@Hinton Hinton changed the title Reorgaize SDK documentation [PM-33733] Reorgaize SDK documentation Apr 10, 2026
Comment thread docs/architecture/sdk/index.md
Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

I've had good luck letting claude do it in the past, but I agree a utility that would create the crate structure, manifest and properly configured client would be nice


## 2. Create the crate

When the functionality warrants its own crate — typically when it represents a distinct domain — add
Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

Should we add more guidance on whether to create a crate vs reuse an existing one, or how big the scope of a crate should be? represents a distinct domain is pretty ambiguous

Copy link
Copy Markdown
Member Author

Choose a reason for hiding this comment

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

It is, but I feel it's partially up to the teams to identify that.

```

If the client will be exposed over WASM, annotate it with
`#[cfg_attr(feature = "wasm", wasm_bindgen)]`.
Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

We don't mention when creating the crate above that the feature needs to exist. Maybe we just always instruct to add a uniffi/wasm feature to all feature crates?

Copy link
Copy Markdown
Member Author

Choose a reason for hiding this comment

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

This ties into my thought for having a template.

Comment thread docs/architecture/sdk/adding-functionality.md
Comment thread docs/architecture/sdk/client-patterns.md Outdated
Comment thread docs/architecture/sdk/adding-functionality.md
@withinfocus withinfocus changed the title [PM-33733] Reorgaize SDK documentation [PM-33733] Reorganize SDK documentation Apr 10, 2026
@Hinton Hinton requested a review from dani-garcia April 13, 2026 12:47
dani-garcia
dani-garcia previously approved these changes Apr 13, 2026
dani-garcia
dani-garcia previously approved these changes Apr 13, 2026
Copy link
Copy Markdown
Contributor

@theMickster theMickster left a comment

Choose a reason for hiding this comment

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

The PR is well-written and does a great job to tidy up a number of heading case issues that resided from prior work. A couple minor adjustments to new headers and I think we are in great shape. Thanks for the great work here, @Hinton!

Comment thread docs/architecture/sdk/index.md Outdated
Comment thread docs/architecture/sdk/index.md Outdated
Comment thread docs/architecture/sdk/index.md Outdated
Comment thread docs/architecture/sdk/index.md Outdated
Comment thread docs/architecture/sdk/secrets-manager.md Outdated
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.

A new Claude skill to add to the ai-plugins marketplace perhaps 🤔

@Hinton Hinton requested a review from dani-garcia April 14, 2026 13:08
@Hinton Hinton merged commit 7093e55 into main Apr 14, 2026
12 checks passed
@Hinton Hinton deleted the sdk-docs branch April 14, 2026 13:20
<Bitwarden>We have compiled a list of resources for learning Rust in a
[Confluence page](https://bitwarden.atlassian.net/wiki/spaces/DEV/pages/517898288/Rust+Learning+Resources).</Bitwarden>
For API documentation view the latest
[API documentation](https://sdk-api-docs.bitwarden.com/bitwarden/index.html) that also includes
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.

This link is broken

Suggested change
[API documentation](https://sdk-api-docs.bitwarden.com/bitwarden/index.html) that also includes
[API documentation](https://sdk-api-docs.bitwarden.com/index.html) that also includes

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.

4 participants