AW: Feature request: api docs

[Reißner Ernst]

On Mon, Feb 7, 2022 at 8:19 AM Reißner Ernst <Ernst.Reissner@corpuls.com> wrote:
> @Gavin Smith : the style I know is putting api docs with the code.
> This turned out to be by far safest to keep docs up to date.
> In java world, in c#, in c and c++ I think this is the accepted way to do it.
> Also in lisp and in python...
> I would wonder if also qt api docs wouldn’t be done that way.

That is almost certainly the case. Compare

https://code.qt.io/cgit/qt/qtbase.git/tree/src/widgets/widgets/qabstractslider.cpp

and

https://doc.qt.io/qt-5/qabstractslider.html.

The QDoc manual: https://doc.qt.io/qt-5/01-qdoc-manual.html

There are also other files used for other material, which doesn't come from 
source code files.

https://doc.qt.io/qt-5/13-qdoc-commands-topics.html#page-command


I think, if all is happy with that solution, we shall implement along the same 
line, right?