hboutemy commented on pull request #278: URL: https://github.com/apache/httpcomponents-client/pull/278#issuecomment-765182182
@ok2c > So, it is not the content you want published but rather the publishing mechanism tested? in fact, both are important: - content, because it's while it is SNAPSHOT that we can improve it: when the source release will be done, documentation will be versioned and any idea of improvement will be a source of frustration, because it will require to wait for next source release - publishing mechanism, because this is where the most discovery and learning is necessary > I still think it would be wrong to use the productive website for that end. Is there a staging repo we could use instead? in fact, current `doc` directory is a staging directory (and can be renamed after the PoC): it is intended to be updated when useful to see latest result, and as a staging area when a release is under vote. Once the vote is ok, it will be copied to a versioned directory with `svn cp`, to keep the state of the documentation at the release time as the definitive release documentation ---------------------------------------------------------------- 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. For queries about this service, please contact Infrastructure at: [email protected] --------------------------------------------------------------------- To unsubscribe, e-mail: [email protected] For additional commands, e-mail: [email protected]
