linagora / james-project

Mirror of Apache James Project
Apache License 2.0
70 stars 63 forks source link

[Antora] [PGSQL] Objectives and motivation page for postgres doc #5188

Closed Arsnael closed 1 week ago

Arsnael commented 1 month ago

Similar to the distributed page: https://james.staged.apache.org/james-distributed-app/3.8.1/objectives.html but oriented for Postgresql James Server

vttranlina commented 2 weeks ago

Q: the antora doc for postgres should be located in james-project/docs or james-project/server/apps/postgres-app ?

Arsnael commented 2 weeks ago

Root folder james-project/docs

The point of migrating the distributed doc back to the root folder was to be able to use a lot of common pieces of doc with distributed as partials, and not having duplicate parts

vttranlina commented 1 week ago

I'm facing some issues with the user interface of Antora (or our bug?)

After the pr https://github.com/linagora/james-project/issues/5186 was merged When I go to https://james.staged.apache.org/ The panel is Screenshot_20240626_091915 When I clicked to 3.8.1 SNAPSHOT Then: image

the "Distributed James Application" section is not visible.

However, when I directly visit the URL https://james.staged.apache.org/james-distributed-app/3.8.1/objectives.htm

I can see the section displayed.

image

Arsnael commented 1 week ago

In servers section, with the other distribution. I guarantee you it's visible => https://james.staged.apache.org/james-project/3.8.1/servers/distributed/index.html

vttranlina commented 1 week ago

In servers section, with the other distribution. I guarantee you it's visible => https://james.staged.apache.org/james-project/3.8.1/servers/distributed/index.html

What is difference between: https://james.staged.apache.org/james-project/3.8.1/servers/distributed/index.html and https://james.staged.apache.org/james-distributed-app/3.8.1/

Arsnael commented 1 week ago

Not sure why https://james.staged.apache.org/james-distributed-app/3.8.1/ is still accessible. Or I missed something in james-website, or this section didn't get cleaned up when being redeployed

IMO not a blocker for now

vttranlina commented 1 week ago

or this section didn't get cleaned up when being redeployed

right, I tried to build james-site locally, and the path **/james-distributed-app/** is not available

vttranlina commented 1 week ago

pr https://github.com/apache/james-project/pull/2316