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 jenkinsci-users+unsubscr...@googlegroups.com.
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