Hi Felix, I think it is the case as you described.
> What is the main documentation of James that should be altered when contributing? Should the other one be kept in sync? Today, we maintain both the Antora docs and the legacy XML docs. I think the goal would be to make the Antora docs complete and mature enough so that eventually we can keep only the Antora doc and replace the XML one. Regards, Quan On Tue, May 19, 2026 at 3:00 PM Felix Auringer <[email protected]> wrote: > Hello everybody, > > I recently added some documentation to james and now I noticed that the > repository actually contains multiple different documentations. > There is the Antora documentation in james-project/docs. It seems like the > one deployed to https://james.staged.apache.org/james-project/3.10.0/. > However, there is also james-project/src which is some XML-based > documentation compiled via maven. I guess it's deployed to > https://james.apache.org/server/? It also contains ADRs (quite recent > ones) and is actively worked on (see e.g. > https://github.com/apache/james-project/commit/d38a23184a6b1dceec37db5fdfe234852eacadcb#diff-cebf9ebcb33a2e6034242e07bca3e163bf1752d879a5ed02192f9056fc138f3a > from last month). > > What is the main documentation of James that should be altered when > contributing? Should the other one be kept in sync? > > Best regards, > Felix > --- > Gesellschaft für interkulturelles > Zusammenleben gGmbH (GIZ) > Felix Auringer > IT > Reformationsplatz 2 > 13597 Berlin > > Tel: 030/513 0100 00; Fax: 030/513 0100 09 > www.giz.berlin; [email protected] > > Amtsgericht Charlottenburg HRB 200872 B > Geschäftsführerin: Dr. Britta Marschke > > --------------------------------------------------------------------- > To unsubscribe, e-mail: [email protected] > For additional commands, e-mail: [email protected] > >
