Uploaded image for project: 'Jenkins'
  1. Jenkins
  2. JENKINS-64839

Shared Library Docs (vars/*.txt) shows only headlines

XMLWordPrintable

      Our Jobs importing a Shared Library with @Library("ci_shared_libraries@2.0.6"). We have several hundred jobs using many different version of the JSL. Most of the jobs are multibranch-type, some are pipeline job. We've also configured an older version of this library as global default.

      When opening the /pipeline-syntax/globals of a job that uses the JSL there is a strange behavior: When running the job for the first time with a new JSL version our docs (vars/*txt) is shown correctly, but starting with the next page reload of /pipeline-syntax/globals the are only unformatted headlines of each vars-function shown (s.Screenshots). This behavior stays the same, unless updating to another (it works also when you change back to an older version) jsl version.


      Our docs (vars/*txt) are formatted as markdown, e.g.

      <!--- This file was generated from the groovydoc-tags in the source code file. Do not edit! --->
      ## epochToDate 
       
      ```groovy 
      java.lang.String epochToDate (java.lang.String epochStr, java.lang.String formatPattern = "dd.MM.yyyy H:mm:ss", java.lang.String zoneId = "Europe/Berlin") 
      ``` 
      Details siehe [API-Docs](https://x.y.z/userContent/docs/ci_shared_libraries/snapshots/latest/groovydoc/DefaultPackage/epochToDate.html) 
      

      Any idea how to fix this or is it a bug? It would be good to have a solution, so our users can use the docs of out jsl.

            Unassigned Unassigned
            svensche Sven Scheil
            Votes:
            0 Vote for this issue
            Watchers:
            2 Start watching this issue

              Created:
              Updated: