+1,

Regards,
Rene.

On 07/10/2021 09:48, btell...@apache.org wrote:
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



---------------------------------------------------------------------
To unsubscribe, e-mail: server-dev-unsubscr...@james.apache.org
For additional commands, e-mail: server-dev-h...@james.apache.org

Reply via email to