Doc: add info about litgen binding generator

[pthom]

Hi,

I am the creator of litgen, an automatic binding generator for pybind11 which generates documented C++ binding code together with python stubs.

Recently it was updated to also support nanobind (with help from @davidlatwe)

This PR proposes to mention litgen in the nanobind documentation, in two parts:

• 9454073: In the building.rst page, I added a section called "Generating binding code automatically," similar to what’s in the pybind11 documentation, to explain litgen’s role in generating documented, discoverable bindings for both pybind11 and nanobind.
• 63f3386: In the porting.rst page, I included a link to the litgen documentation, highlighting examples that compare pybind11 and nanobind binding code side by side. This should be helpful for users looking to understand key differences.

Feel free to discard the part in the porting.rst page if you feel it does not bring enough value.

Thanks!

Pascal Thomet

[pthom]

Hello Wenzel ( @wjakob ),

Could you have a look at this PR and tell me your opinion (or close it if you feel it does not fit here).

Cheers,

Pascal

[wjakob]

Hi @pthom,

I think it's useful to mention it somewhere in the documentation, but I would like to do so outside of the main tutorial-style introduction. I prefer people to know how to write bindings themselves and not give the impression that going through an automated tool is the officially recommended way to use nanobind. I think what you are doing is great and that you can understand my viewpoint.

[pthom]

Hi Wenzel,

Of course, I get your point!

I think this means that:

• adding info about it in "building.rst", since it is also part of the tutorial style intro
• adding info about it in "porting.rst" is not a good place to present it

So, I do not know where it could be added.

I thought about adding a dedicated page in the advanced section, but it would be a bit cumbersome, since this page would be mostly empty (and not really related to the advanced subjects).

I think I'll add an item to the discussions on this repo, and it might be enough.

[pthom]

Feel free to close this PR

[wjakob]

What about an FAQ entry? E.g. "Is there a tool to generate nanobind bindings automatically"?

[pthom]

What about an FAQ entry? E.g. "Is there a tool to generate nanobind bindings automatically"?

Thanks for the suggestion! I just did this.

[wjakob]

Thanks!