Hello Peter, > -----Original Message----- > From: Peter Kovacs [mailto:pe...@apache.org] > Sent: Sunday, October 17, 2021 11:18 PM > To: dev@openoffice.apache.org > Subject: Re: API doc on web site [Was: Accessing the comment > object (annotation) in Draw/Impress via API]
> The API Documentation is extracted from the Code. > > For example the comment in > > http://opengrok.openoffice.org/xref/aoo41x/main/offapi/com/sun > /star/modules.idl?r=d1766043#83 > > does have an impact on the web page: > > https://www.openoffice.org/api/docs/common/ref/com/sun/star/of > fice/module-ix.html > > I hope you see both documentations are linked. So when do we > update the > documentation on the web site? > > Currently we will never update the web site, and the danger > is that if > we change a comment in the documentation it will not end up > on the website.. > > So Arrigos Idea is to update with each release. This would keep the > documentation on the web in sync with the latest Code > released for this > API Version (Which should roughly correspond with the major release). > > It makes sense to publish on the website which Code the > extraction has > been taken from and what Versions the Documentation relates to. > > On an API Change, QA and documentation Versions need to be > discussed. yes, exactly. > But we can discuss this when we get near to a API Change. I > think until > then we have done some steps in respect of QA. How do you come to this hope, so we can all see that there is no regulated QA for years? Basically there is no real QA since Raphael left the project. That's just a description of the situation, because we lack enough volunteers to build up a really sufficient QA. But volunteers have to be motivated and for this we have to recognize performance and not admit people to the PMC according to personal preference (called alleged "merit"), but only according to performance. For example, we should have discussed honestly and factually how it came to the release mikt the (so-called) 'Big Sur Bug', to improve our release procedures, that such gross errors no longer occur. But nothing happened. '9 years as a top level project' ... well, I've been in the OO project for more than 16 years ... Jörg --------------------------------------------------------------------- To unsubscribe, e-mail: dev-unsubscr...@openoffice.apache.org For additional commands, e-mail: dev-h...@openoffice.apache.org
