On 26/12/2020 20:48, Stefan Seelmann wrote:
TBH I'm confused about the locations we put the generated docs but also
the studio userguide.
With the old CMS everything was in SVN.
Well, it was a bit different. Gen docs were pushed into the production
repo, while le other pieces were pushed into the staged repo. When the
site was published, everything was merged into a static site that was
accessible for everyone.
Now the current docs are at https://nightlies.apache.org/, but it seems
very few projects use that server and it's meant for nightly builds
rather than serving docs?. I'm a bit afraid that we don't use the right
tool? Is it the recommended by infra to use it for our purpose?
Infra suggested to use this weird location. Not our choice.
Currently, only the latest revision for each project is stored there.
For old docs archive.apache.org seems right, but can we directly push
there?
I don't think so. AFAICT, every time we push a new release, the previous
one is moved to archive, so we don't have a hand on what is pushed on
this server. I will ask infra.
It's also a bit of a pain because we then need to push the docs
to both, nightlies.a.o and to archive.a.o.
Or we can benefit from teh same mechanism.
Why don't we add the docs to the directory-site git repo directly?
Because it's HUUUUUGE. We are talking about 4Gb of data. Imagine having
to clone this repo...
Maybe
I missed a previous discussion. I admit that it would increase the repo
size, but maybe it's possible to move it to a dedicated branch?
Kind Regards,
Stefan
On 12/26/20 7:25 PM, Emmanuel Lécharny wrote:
OTOH, pointing on svn does not seems like a good idea ...
May be we could push the old javadocs to
https://archive.apache.org/dist/directory/[project]/dist/ ?
On 26/12/2020 17:06, Emmanuel Lécharny wrote:
Hi !
we have pages refering to the old generated docs (javadoc, xref) for
all of our projects (api, apacheds, fortress, mavibot). Those links
are all broken, but the latest version which has been uploaded to
https://nightlies.apache.org/directory.
The older versions are still available at
https://svn.apache.org/repos/infra/websites/production/directory/content/[project]/gen-docs/[version].
This repo will not change as we now have switched to git, but I guess
we can still refer to it in out site, until we find a better solution
? Like, moving all the older docs to nightlies.
wdyt ?
---------------------------------------------------------------------
To unsubscribe, e-mail: [email protected]
For additional commands, e-mail: [email protected]
---------------------------------------------------------------------
To unsubscribe, e-mail: [email protected]
For additional commands, e-mail: [email protected]
---------------------------------------------------------------------
To unsubscribe, e-mail: [email protected]
For additional commands, e-mail: [email protected]
