Plugin documentation not showing on site

[Jean-Marc Meessen]

Hello,

I am scratching my head with the plugin documentation. One day it shows on the site and the next day it doesn't (at least I am led to believe that).

I have a README.md in the root of the workspace and the POM's <URL> seems properly configured. Any ideas or explanations?

• documentation page: https://plugins.jenkins.io/webhook-step/
• github: https://github.com/jenkinsci/webhook-step-plugin 
• URL definition: https://github.com/jenkinsci/webhook-step-plugin/blob/master/pom.xml#L26

/- Jmm 

[Adrien Lecharpentier]

Hello Jean-Marc,

to my knowledge, the documentation generation requires a release and then has some delay before showing up. This might still be the case and the problem you are facing.

--
You received this message because you are subscribed to the Google Groups "Jenkins Developers" group.
To unsubscribe from this group and stop receiving emails from it, send an email to jenkinsci-de...@googlegroups.com.
To view this discussion on the web visit https://groups.google.com/d/msgid/jenkinsci-dev/CABLvyXysQM6TY%3D%2B%3DBN8kiBpgL2dF50EjggTk5fG1T3PWE%3DgJ0w%40mail.gmail.com.

[Daniel Beck]

On Thu, Nov 18, 2021 at 11:48 AM Jean-Marc Meessen <jean...@meessen-web.org> wrote:

I have a README.md in the root of the workspace and the POM's <URL> seems properly configured. Any ideas or explanations?

While changes to README.md are effective quickly (~caching) once that's known to be the documentation location, changes to the URL in pom.xml require a plugin release.

[Daniel Beck]

Oops, missed the tag from CD. So the plugin site knows docs are in GH, as it explicitly links there in the sidebar.

What exactly is the problem? It may simply be an occasional temporary issue with the GH API, if instead of inline docs it shows "Documentation is at https://github.com/org/repo".

[Tim Jacomb]

The docs are showing for me currently

--

You received this message because you are subscribed to the Google Groups "Jenkins Developers" group.
To unsubscribe from this group and stop receiving emails from it, send an email to jenkinsci-de...@googlegroups.com.

To view this discussion on the web visit https://groups.google.com/d/msgid/jenkinsci-dev/CAMo7PtKvt0dpSLs3j5sZoi9U7oo98h0SvWhz%2B3%2Bac_e%3DJgYkqQ%40mail.gmail.com.

[Jean-Marc Meessen]

Thanks for chiming in on this.

I think that the unexpected behavior was caused by the Jenkins.io "Guru Meditation" (unavailability) that occurred this late morning (CET). As Tim pointed out, everything is back to normal.

/- Jmm

To view this discussion on the web visit https://groups.google.com/d/msgid/jenkinsci-dev/CAH-3BieqaP0bySG3xfan5VRZAC0jL1fv%2Bguv46-mj0CtKt3sGg%40mail.gmail.com.