[GitHub] [incubator-pekko] jrudolph commented on issue #179: change location where we store nightlies docs

["jrudolph (via GitHub)" <gi...@apache.org>]

jrudolph commented on issue #179:
URL: https://github.com/apache/incubator-pekko/issues/179#issuecomment-1427876085

   First of all, let's not optimize paths on the nightly server for public consumption. If we have to serve using redirects from this domain, it's just a bandaid we should try to get rid of. In any case, we should never point any public links to it (but we might be required to use `.htaccess` to serve documentation).
   
   That said, we should just choose a folder layout that helps organizing all the bits in the best way. I assumed we would get a top-level folder for all subprojects but I might have misunderstood that. The current layout is modeled after what flink does but they don't have many subprojects so deviating from that makes sense.
   
   The `current` folder (or symlink) in Akka does not point to the latest snapshot but to the latest released public version, so if we are for consistency we shouldn't be using `current` for snapshots. Maybe we could organize it like this:
   
    * pekko/docs/pekko/snapshot-main/{docs,api,japi}: published from main branch of pekko
    * pekko/docs/pekko-http/snapshot-main/{docs,api,japi}: published from main branch of pekko-http
    * etc
    * pekko/docs/pekko/snapshot-release-1.0/{docs,api,japi}: published from release 1.0 branch of pekko
    * (if necessary) pekko/docs/pekko/1.0.0/{docs,api,japi}: released version of docs for public 1.0.0 version
    * (if necessary) pekko/docs/pekko/current/: link to the latest released version of docs
   
   We should still strive to serve public release docs from the proper domain and it's probably totally possible to use the git based infra for that.


-- 
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.

To unsubscribe, e-mail: notifications-unsubscribe@pekko.apache.org

For queries about this service, please contact Infrastructure at:
users@infra.apache.org


---------------------------------------------------------------------
To unsubscribe, e-mail: notifications-unsubscribe@pekko.apache.org
For additional commands, e-mail: notifications-help@pekko.apache.org