Am 2020-10-27 um 14:04 schrieb Herve Boutemy:
Hi,
As asked by Michael, I had a quick look at your current setup, your pain points
and what can be done to improve your experience.
I just proposed one little PR to go step by step:
https://github.com/apache/httpcomponents-website/pull/4
With that setup, building and deploying the main site is just "mvn site-deploy".
As explain in the PR comment: "Once this step is ok from a developer point of view, run on his
local machine, next step will be to configure a Jenkins job to do mvn site-deploy automatically
when updating source content: from there, many little improvements can be done (testing Markdown
and/or Asciidoc source instead of apt, improving site.xml, reworking the skin to add the
"edit" icon in breadcrumb, ...)"
On the question of "piecing together content of multiple releases into a single web
site", this is the next step that will improve performance but requires some
structure change (and 1 infra task done by infra): IMHO, we should discuss that once the
previous non-invasive steps are working, then you start having a better confidence based
on better experience.
once 1 dev is able to rebuild and publish from his computer with "mvn
site-deploy", I can provide you a few light improvements to see the site evolve with
the new setup: just tell me once it works and you are ready to try next steps
Hervé,
I have merged your PR. It does run for me locally as well as with "mvn
site-deploy". Set up the Jenkins job just like maven-site, but it still
fails for me [1]:
ERROR: Could not find the JDK installation: JDK 1.8 (latest). Make sure
it is configured on the Global Tool Configuration page
What to do?
Michael
[1]
https://ci-builds.apache.org/job/HttpComponents/job/HttpComponents%20Website/job/master/1/console
---------------------------------------------------------------------
To unsubscribe, e-mail: [email protected]
For additional commands, e-mail: [email protected]
