Re: Plugin documentation not showing on site

[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

Le jeu. 18 nov. 2021 à 13:22, Tim Jacomb  a écrit :

> The docs are showing for me currently
>
> On Thu, 18 Nov 2021 at 12:16, 'Daniel Beck' via Jenkins Developers <
> jenkinsci-dev@googlegroups.com> wrote:
>
>>
>>
>> On Thu, Nov 18, 2021 at 1:13 PM Daniel Beck  wrote:
>>
>>>
>>>
>>> On Thu, Nov 18, 2021 at 11:48 AM Jean-Marc Meessen <
>>> jean-m...@meessen-web.org> wrote:
>>>

 I have a README.md in the root of the workspace and the POM's 
 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.
>>>
>>
>> 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;.
>>
>> --
>> 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-dev+unsubscr...@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
>> 
>> .
>>
> --
> 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-dev+unsubscr...@googlegroups.com.
> To view this discussion on the web visit
> https://groups.google.com/d/msgid/jenkinsci-dev/CAH-3BieqaP0bySG3xfan5VRZAC0jL1fv%2Bguv46-mj0CtKt3sGg%40mail.gmail.com
> 
> .
>

-- 
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-dev+unsubscr...@googlegroups.com.
To view this discussion on the web visit 
https://groups.google.com/d/msgid/jenkinsci-dev/CABLvyXwqQiX2NXoZ6SCUdwAOubjG0YNbie8B4ob4N_ELXDchdg%40mail.gmail.com.

Re: Plugin documentation not showing on site

[Tim Jacomb]

The docs are showing for me currently

On Thu, 18 Nov 2021 at 12:16, 'Daniel Beck' via Jenkins Developers <
jenkinsci-dev@googlegroups.com> wrote:

>
>
> On Thu, Nov 18, 2021 at 1:13 PM Daniel Beck  wrote:
>
>>
>>
>> On Thu, Nov 18, 2021 at 11:48 AM Jean-Marc Meessen <
>> jean-m...@meessen-web.org> wrote:
>>
>>>
>>> I have a README.md in the root of the workspace and the POM's 
>>> 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.
>>
>
> 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;.
>
> --
> 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-dev+unsubscr...@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
> 
> .
>

-- 
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-dev+unsubscr...@googlegroups.com.
To view this discussion on the web visit 
https://groups.google.com/d/msgid/jenkinsci-dev/CAH-3BieqaP0bySG3xfan5VRZAC0jL1fv%2Bguv46-mj0CtKt3sGg%40mail.gmail.com.

Re: Plugin documentation not showing on site

['Daniel Beck' via Jenkins Developers]

On Thu, Nov 18, 2021 at 1:13 PM Daniel Beck  wrote:

>
>
> On Thu, Nov 18, 2021 at 11:48 AM Jean-Marc Meessen <
> jean-m...@meessen-web.org> wrote:
>
>>
>> I have a README.md in the root of the workspace and the POM's  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.
>

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;.

-- 
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-dev+unsubscr...@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.

Re: Plugin documentation not showing on site

['Daniel Beck' via Jenkins Developers]

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

>
> I have a README.md in the root of the workspace and the POM's  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.

-- 
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-dev+unsubscr...@googlegroups.com.
To view this discussion on the web visit 
https://groups.google.com/d/msgid/jenkinsci-dev/CAMo7PtKzwhfRB8tDebQPAyR0xunRtdwbj3geta9SjHvTkE9zuA%40mail.gmail.com.

Re: Plugin documentation not showing on site

[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.


Le jeu. 18 nov. 2021 à 11:48, Jean-Marc Meessen 
a écrit :

> 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  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
>
> --
> 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-dev+unsubscr...@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
> 
> .
>

-- 
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-dev+unsubscr...@googlegroups.com.
To view this discussion on the web visit 
https://groups.google.com/d/msgid/jenkinsci-dev/CAKwJSvy-ySejtVqTvjh%3Dpcj75sBASKyQPjJa7B%3DZjVU96My8RQ%40mail.gmail.com.

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  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

-- 
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-dev+unsubscr...@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.