docs: add tos config and a specific schema example in write lance

[huleilei]

Changes Made

Related Issues

[greptile-apps]

Greptile Overview

Greptile Summary

Adds TOS (Volcengine) configuration example and schema specification documentation for Lance writes.

Key Issues:

• TOS endpoint URL has critical syntax errors: incorrect domain (ivolces.com should be volces.com) and wrong format (tos-s3-{region} should be tos-{region}) - this will cause runtime connection failures
• Introductory text is misleading - mentions "public S3/GCS buckets" but shows private TOS authentication
• Minor style inconsistency with capitalization of "e.g."

Note: The same TOS endpoint errors exist in the pre-existing reading section (line 72), suggesting this is a broader documentation issue in the codebase that should be fixed systematically.

Confidence Score: 1/5

• This PR contains critical syntax errors that will cause runtime failures when users try to connect to TOS
• Score reflects blocking issues: the incorrect TOS endpoint format and domain typo will prevent successful connections. While the schema documentation is correct, the TOS example would fail in production use.
• docs/connectors/lance.md requires fixes to TOS endpoint URLs before merging

Important Files Changed

File Analysis

Filename	Score	Overview
docs/connectors/lance.md	2/5	Added TOS configuration example and schema documentation. Found critical syntax errors in TOS endpoint URL (wrong domain and format), misleading intro text, and minor style inconsistency.

Sequence Diagram

sequenceDiagram
    participant User
    participant Daft
    participant TOS as Volcengine TOS
    participant Lance as Lance Format

    User->>Daft: df.write_lance(uri, io_config)
    Daft->>Daft: Apply schema if provided
    Daft->>TOS: Connect via S3Config endpoint
    Note over Daft,TOS: ❌ Current: tos-s3-{region}.ivolces.com<br/>✅ Correct: tos-{region}.volces.com
    TOS-->>Daft: Connection established
    Daft->>Lance: Write data in Lance format
    Lance->>TOS: Store Lance files
    TOS-->>Lance: Confirm write
    Lance-->>Daft: Write metadata
    Daft-->>User: Return metadata DataFrame

Loading

[greptile-apps]

Incorrect TOS endpoint URL format and domain typo. Should be tos-{region}.volces.com not tos-s3-{region}.ivolces.com. The Rust implementation in src/common/io-config/src/tos.rs uses the correct format.

Suggested change

	endpoint_url=f"https://tos-s3-{region}.ivolces.com",
	endpoint_url=f"https://tos-{region}.volces.com",

Prompt To Fix With AI

This is a comment left during a code review.
Path: docs/connectors/lance.md
Line: 138:138

Comment:
Incorrect TOS endpoint URL format and domain typo. Should be `tos-{region}.volces.com` not `tos-s3-{region}.ivolces.com`. The Rust implementation in `src/common/io-config/src/tos.rs` uses the correct format.

```suggestion
            endpoint_url=f"https://tos-{region}.volces.com",
```

How can I resolve this? If you propose a fix, please make it concise.

[huleilei]

There is right with endpoint_url=f"https://tos-s3-{region}.ivolces.com",

[kevinzwang]

Let me know when this is ready to be merged!

[huleilei]

@kevinzwang help me review when you are convenient. Thanks