Issue found on page 'C API'

[tdunning]

Please describe the problem you encountered in the DuckDB documentation and include the "Page URL" link shown below.
Note: only create an issue if you wish to report a problem with the DuckDB documentation. For questions about DuckDB or the use of certain DuckDB features, use GitHub Discussions, Stack Overflow, or Discord.

Page URL: https://duckdb.org/docs/api/cpp.html

I think that the OrrifiedVector nomenclature has been removed from the code.

[Tishj]

Yea that's true, it's been replaced by UnifiedVectorFormat and Vector::ToUnifiedFormat(idx_t size, UnifiedVectorFormat &output)

[tdunning]

How does a doc page get updated?

There are other problems with these examples as well and the codebase is essentially undocumented. The sample extension is nice, but it only deals with the very simplest of cases (primitive types, scalar function). I have a need to deal with structs and lists as arguments and return types and it is very slow going trying to figure out what will work. Lots of trial and error.

[Tishj]

You're welcome to contribute to the docs, as you've found this part of the docs is very old and hasn't been touched in a while

[tdunning]

That's nice in theory, but what the docs need is what I need to learn about. I can't very well contribute unless I know what's going on.

So far, the only thing that I can contribute is that I can't use this part of the documentation to achieve the goal of building more than a trivial extension. Period. That is definitely a contribution (naive eyes are always valuable and fleeting). But it only highlights the problem. It can't solve it.

[szarnyasg]

Hi @tdunning, thanks for the feedback. I understand the frustration – this part of the documentation is lacking several important pieces of information. We plan to improve it in the future but it will take time as there are several other key issues (see the issue tracker of the repository) that need to be tackled.

For now, I recommend studying what other extensions (including the core DuckDB extensions and the community extensions) are doing. You are also welcome to join the #community-extensions channel on Discord.