Hello, We should merge all into one place, it will be better readability, easy lookup, less cost, and It will avoid the inconsistency problem.
Regards, Tung On Thu, Oct 7, 2021 at 9:08 AM btell...@apache.org <btell...@apache.org> wrote: > Hello there, > > WebAdmin is documented on the following way: > > - (old) documentation through manual markdown files > - (new) Antora documentation though manual ASCII files > > We also have an old Swagger documentation that (to my knowledge) have > never been deployed, is partial, badly documents returned POJOs. It is > not tied to the inner working of WebAdmin thus not meeting the promise > of Swagger doc: differences can arise. Moreover, the generation logic > for it is complex, and hard to maintain. > > As such I would propose to simplify our lives, remove the Swagger docs > and fully rely on the markdown/ASCIIDOC ones. > > Feedbacks? > > Benoit > > > --------------------------------------------------------------------- > To unsubscribe, e-mail: server-dev-unsubscr...@james.apache.org > For additional commands, e-mail: server-dev-h...@james.apache.org > > -- Tung, Tran Van *Phone:* (+84) 35 757 6258 *Skype:* tung.tv202
