Re: Documentation
Benoit TELLIER <[email protected]> Tue, 19 May 2026 12:06:20 +0000
| Newsgroups | gmane.comp.jakarta.james.devel |
|---|---|
| Message-ID | <[email protected]> |
---=Part.93.c02f2580b4166581.19e40213c90.cd00ccf72aa7ace6=- Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: quoted-printable Accept-Language: fr-FR, en-US, vi-VN, ru-RU, ar-TN, it-IT, de-DE Content-Language: en-US The goal is to eventually switch fully to Antora (/docs) and remove fully l= egacy website (/src/site - currently deployed with pain)=C2=A0 We would re= tain homepage (src/homepage) Antora needs a lot of cleanup to make it happ= en=2E Especially: =C2=A0- We shall better aggregate doc from libraries (MIM= E4J, JDKIM, JSPF, JSIEVE) =C2=A0- We shall IMO remove concepts and develope= r guide version =C2=A0- Some items like download needs to be adapted =C2=A0= - We NEED to handle documentation at least for JPA (today called basic=2E= =2E=2E) =C2=A0- I'd love to remove spring app so I bet this is no longer ne= eded in the doc=2E =C2=A0- Relook it a bit and ship it ! src/adr is unrela= ted and not incorporated on any websites=2E=2E=2E We shall still writte adr= s on significant changes=2E Does this address your questions ?--=C2=A0 Be= st regards, Benoit TELLIER General manager of Linagora VIETNAM=2E Product= owner for Twake-Mail product=2E Chairman of the Apache James project=2E M= ail: btellier@linagora=2Ecom Tel: (0033) 6 77 26 04 58 (WhatsApp, Signal) = On May 19, 2026 10:06 AM, from Quan Tran Hong <quan=2Etranhong1999@gmail= =2Ecom>Hi Felix, I think it is the case as you described=2E > What is = the main documentation of James that should be altered when contributing? S= hould the other one be kept in sync? Today, we maintain both the Antora do= cs and the legacy XML docs=2E I think the goal would be to make the Antora= docs complete and mature enough so that eventually we can keep only the An= tora doc and replace the XML one=2E Regards, Quan On Tue, May 19, 2026 a= t 3:00=E2=80=AFPM Felix Auringer wrote: > Hello everybody, > > I= recently added some documentation to james and now I noticed that the >= repository actually contains multiple different documentations=2E > The= re is the Antora documentation in james-project/docs=2E It seems like the &= gt; one deployed to james=2Estaged=2Eapache=2Eorg/james-project/3=2E10=2E0/= =2E > However, there is also james-project/src which is some XML-based &= gt; documentation compiled via maven=2E I guess it's deployed to > james= =2Eapache=2Eorg/server/? It also contains ADRs (quite recent > ones) and= is actively worked on (see e=2Eg=2E > github=2Ecom/apache/james-project= /commit/d38a23184a6b1dceec37db5fdfe234852eacadcb#diff-cebf9ebcb33a2e6034242= e07bca3e163bf1752d879a5ed02192f9056fc138f3a > from last month)=2E > &= gt; What is the main documentation of James that should be altered when >= ; contributing? Should the other one be kept in sync? > > Best regard= s, > Felix > --- > Gesellschaft f=C3=BCr interkulturelles > Zus= ammenleben gGmbH (GIZ) > Felix Auringer > IT > Reformationsplatz 2= > 13597 Berlin > > Tel: 030/513 0100 00; Fax: 030/513 0100 09 >= ; giz=2Eberlin; felix=2Eauringer@giz=2Eberlin > > Amtsgericht Charlot= tenburg HRB 200872 B > Gesch=C3=A4ftsf=C3=BChrerin: Dr=2E Britta Marschk= e > > ---------------------------------------------------------------= ------ > To unsubscribe, e-mail: server-dev-unsubscribe@james=2Eapache= =2Eorg > For additional commands, e-mail: server-dev-help@james=2Eapache= =2Eorg > > ---=Part.93.c02f2580b4166581.19e40213c90.cd00ccf72aa7ace6=---