The goal is to eventually switch fully to Antora (/docs) and remove fully legacy website (/src/site - currently deployed with pain)
We would retain homepage (src/homepage) Antora needs a lot of cleanup to make it happen. Especially: - We shall better aggregate doc from libraries (MIME4J, JDKIM, JSPF, JSIEVE) - We shall IMO remove concepts and developer guide version - Some items like download needs to be adapted - We NEED to handle documentation at least for JPA (today called basic...) - I'd love to remove spring app so I bet this is no longer needed in the doc. - Relook it a bit and ship it ! src/adr is unrelated and not incorporated on any websites... We shall still writte adrs on significant changes. Does this address your questions ?-- Best regards, Benoit TELLIER General manager of Linagora VIETNAM. Product owner for Twake-Mail product. Chairman of the Apache James project. Mail: [email protected] Tel: (0033) 6 77 26 04 58 (WhatsApp, Signal) On May 19, 2026 10:06 AM, from Quan Tran Hong <[email protected]>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 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 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 > james.apache.org/server/? It also contains ADRs (quite recent > ones) and is actively worked on (see e.g. > 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 > 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] > >
