[Jenkins-infra] Javadoc.jenkins.io as a standalone service

[Olblak]

Hi Oleg,
Nice initiative, do you already have something that people can
iterate on?I can create an infra ticket to keep track of this.

---
-> gpg --keyserver keys.gnupg.net --recv-key 52210D3D
---




On Mon, Jul 16, 2018, at 2:28 PM, Oleg Nenashev wrote:
> Hi Olivier,
> 
> I was about creating a Javadoc landing page when I was working on the
> component Javadoc support.> But I have never got to it unfortunately.
> 
> So yes, currently the "official" way to get to Javadoc lists is to
> use GitHub.> Should be trivial to fix by updating
> https://jenkins.io/doc/developer/javadoc/ or maybe by adding a custom
> header to all Javadoc outputs (like Jenkins Javadoc plugin does).> 
> BR, Oleg
> 
> 
> 
> 
> On Mon, Jul 16, 2018 at 2:55 PM, Olblak <me at olblak.com> wrote:
>> 
>> Hello,
>>  I recently updated https://javadoc.jenkins.io in order to
>> 
>>  1. Update it more frequently [INFRA-1600]
>>  2. Enable HTTPS support  [INFRA-1387]
>>  3. Move it to Azure [INFRA-1426]
>> 
>>  But I also found the UX quite inconvenient with hidden information
>>  depending how you arrive on that service.>> 
>>  Scenario 1, you get there via
>>  https://jenkins.io/doc/developer/javadoc/ and then it's kind of OK.>>  Scenario 2, you get there via https://javadoc.jenkins.io and you
>>  have no way to know about https://javadoc.jenkins.io/component or
>>  https://javadoc.jenkins.io/plugin.>> 
>>  Is there any other way to access the javadoc?
>> 
>>  Maybe I am the only one but instinctively I would follow scenario 2
>>  and expect 'jenkins.io/doc/developer/javadoc' to be the same than
>>  'javadoc.jenkins.io'.>>  I would also expect javadoc to be a standalone service, where
>>  everything is defined from https://github.com/jenkins-infra/javadoc
>>  without having to go on github.com/jenkins-infra/jenkins.io.>> 
>>  What's your thought about this?
>>  _______________________________________________
>>  Jenkins-infra mailing list
>> Jenkins-infra at lists.jenkins-ci.org
>> http://lists.jenkins-ci.org/mailman/listinfo/jenkins-infra

-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://lists.jenkins-ci.org/pipermail/jenkins-infra/attachments/20180716/97336c1a/attachment.html>