# Re: \[PATCH 1/9\] kernel/api: introduce kernel API specification framework

- From: Jonathan Corbet \<corbet@lwn.net\>
- Date: 2026-03-18 16:50:42 
- List: linux-api
- Page: https://ratatoskr.run/linux-api/2026/03/343879
- Thread: https://ratatoskr.run/linux-api/2026/03/343369/t.md

```text
Sasha Levin [ref] writes:

>>> +The framework exports specifications via debugfs that can be used
>>> +to generate documentation. Tools for automatic documentation generation
>>> +from specifications are planned for future development.
>>
>>Documentation always comes last :)
>
> So this is one thing I wanted to run by the doc maintainers: the kapi tool
> already has the capability to export these specs in .rst format. Would it be
> interesting to have a manual for kenrel APIs in Documentation/? It can be
> automatically generated and updated and would always match the kernel code at
> that point.

I suspect we could certainly find a place for it.  Maybe as a subsection
of the user-space API manual, at least for the system-call portion of
it.

Thanks,

jon
```