Agree, in my opinion the long term place is the Antora documentation. We might have to live with Antora <-> Markdown (old website) duplication for a while longer, until we fully adopt Antora website documentation.
Regards, Benoit On 07/10/2021 09:12, Tung Tran Van wrote: > 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 >> >> --------------------------------------------------------------------- To unsubscribe, e-mail: server-dev-unsubscr...@james.apache.org For additional commands, e-mail: server-dev-h...@james.apache.org
