Document how to update doc repo about docs.raku.org HOT 8 CLOSED

I thought the update was unprotected and that anyone could initiate a site update; if it requires a secret token I have no concern.

from docs.raku.org.

Can you please elaborate, do you mean loading a new version of the doc repo while the site is still running, replacing or in the future completing the existing content, or?

from docs.raku.org.

I mean a new version of the doc repo on an already running instance of the website.

Once we're deployed and running on docs.raku.org, this will be a common use case.

from docs.raku.org.

That's something to implement, yes.

from docs.raku.org.

Wrote a prototype locally, need time to cleanup the code.

Right now the basic API is "get the git describe" of the doc repo used and an "update" command sent with a secret token, doing the "update the repo, registry and remove cache of the changed pages". So to update the version to latest what's needed is a ping to docs.raku.org/update?token=... and it does the thing.

Can be also configured to do an update every hour/day or something.

@coke does the process looks sensible to you in a long run?

from docs.raku.org.

I don't like making this a public interface as it could be invoked by anyone and lead to a DDOS.

from docs.raku.org.

The update action is protected with a secret token (no token = forbidden), so it can lead to a DDOS as DDOS-ing every other page would, no?

from docs.raku.org.

Resolved, the docs are updated too.

from docs.raku.org.