So I now have a handful of pipeline scripts all reusing some global 
methods, all of which I pasted into each script, so I've started to set up 
a shared library to avoid duplication.

I'm using https://jenkins.io/doc/book/pipeline/shared-libraries/ as my 
implementation guide.

My questions have to do with the following block:

The vars directory hosts scripts that define global variables accessible 
> from Pipeline. The basename of each *.groovy file should be a Groovy (~ 
> Java) identifier, conventionally camelCased. The matching *.txt, if 
> present, can contain documentation, processed through the system’s 
> configured markup formatter (so may really be HTML, Markdown, etc., though 
> the txt extension is required).


The first thing I need to define isn't what you might call a "global 
variable", but a method.  I know they are the same thing, but I think this 
could be clearer to people who are perhaps less than experts if this 
described "global variables or methods".  I'll submit that suggestion in a 
PR, but that's not quite what I'm asking about here.

I'm wondering about this "matching *.txt" file.  It says it "can contain 
documentation, ...".  The problem is, this page says nothing about how that 
documentation is used or presented. How is this file actually used?

-- 
You received this message because you are subscribed to the Google Groups 
"Jenkins Users" group.
To unsubscribe from this group and stop receiving emails from it, send an email 
to [email protected].
To view this discussion on the web visit 
https://groups.google.com/d/msgid/jenkinsci-users/e5b4d373-0cf5-40fe-ab46-76cb10bbdca3%40googlegroups.com.
For more options, visit https://groups.google.com/d/optout.

Reply via email to