►
From YouTube: 2021 12 06 Docs Office Hours
Description
Documentation office hours with an overview of recent events, detailed review of the changelog for tomorrow's weekly release, and discussion of the Modernizing a Jenkins plugin tutorial and blog post.
A
Welcome
to
doc's
office
hours
it's
december,
the
6th.
Remember
we
abide
by
the
jenkins
code
of
conduct,
so
let's.
A
Agenda
topics
I
had
I've
got
some
news
that
I
wanted
to
share
a
weekly
change
log
pr
review,
modernizing
a
plug-in
blog
post
make
any
topics
you
want
to
add
direct
any
topics
you
want
to
add.
A
B
D
B
A
A
Serious
problem,
because
the
navigation
is
now
broken
on
this
one
I'll
have
to
okay
time
for
a
bug
report.
That's
okay,
so
bug
interesting,
so
I
click
that,
but
it
doesn't
have,
but
it
does
have
to
hover
over
it.
A
So
that
hover
works
right,
yes,
but
but
it's
reworked
the
the
links
from
the
adoc
with
plugin-content
dash
prefix,
but
of
course,
the
ascii
doctor,
the
aadoc
generated
hyperlinks
internally,
don't
have
that?
Okay,
so
I'll,
just
I've
got
to
report
a
bug.
A
A
A
A
All
right
so
new
issue,
a
doc
contents
table
of
contents
links.
A
Sorry,
do
you
mind
if
I
do
this
now,
while
we're
on
it
thanks,
not
at
all
broken
in
a
doc
pages
on
plugins
site,
okay,
so
plugins
that
use
the
use,
adoc
format
and
embed
a
table
of
content,
a
computed
table
of
contents.
A
Okay,
oops.
C
A
Prefix,
it
worked
without
it
because
if
we,
if
we
open
this
page
on
the
get
actually
let's
this
is,
this
is
fun
because
it's
impressive
how
much
gavin
has
done
and
how
wonderful
the
work
is
he
does
here
is
the
github
page.
Now,
if
I
open
the
readme
here
notice
that
it's
got
the
table
of
contents
items
and
these
hyperlinks
work,
even
though,
when
we
look
at
the
source
code,
there
is
no
table
of
contents.
A
All
there
is
is
this
table
of
contents
macro
that
causes
a
doc
to
generate
the
table
of
contents
for
it?
So
so
that's
this
magic
here
of
this
talk
macro
is
the
thing
that
I
I
liked
about,
adoc,
that
until
github
did
their
extensions
wasn't
available
with
github.
It
is
now
available
with
github.
I
just
haven't
made
any
transition
to
switch
this
from
adoc
to
to
markdown.
A
Yeah,
so
so
we've
reported
it
now
we
can,
we
can
go
on.
Yes,
that's
great,
so
pleased
to
announce
that
2.319.1
is
released
and
with
our
changelog.
Thank
you
dhiraj.
Thank
you,
meg,
thank
you
to
kristen
yay,
and
the
next
release
is
scheduled
two
weeks
later
than
the
typical
time
it
would
have
normally
fallen
on
december
29th
and
december.
29Th
is
a
time
when
I
intend
to
be
on
vacation
personally,
it's
my
end
of
year,
holidays
and
and
others
may
be
doing
the
same.
Although
meg
you
should
be
in
holidays
right
now,
right
yeah,.
A
All
right
any
other
news,
anyone
else
needs
to
share.
C
A
Exactly
astonishing,
so
in
in
the
little
community
where
I
live,
we
just
had
an
election
for
a
person
in
our
local
government
that
was
decided
by
literally
one
vote
out
of
thousands
of
votes.
One
vote
was
the
difference
between
the
two
so
so
meg.
It's
important
that
you
vote
next
year.
A
A
A
A
And
I
don't
know
that
that
belongs
in
the
in
the
change
log
or
not,
but
I
I
guess
let's,
let's
call
it
yes
for
now.
What
do
you
think,
because
developers
probably
do
care
very
much
about
it
this
next
one
I
would
propose.
We
do
a
skip,
jnr,
posix
patch
revision.
I
don't
think
generally
is
worth
mentioning.
A
So
I
propose
to
declare
to
skip
changelog,
okay
and
let's
see,
if
there's
any
comment
that
said
nope,
so
I
think
they
would
not
object
good
all
right
next
nope.
Okay,
we
did
that.
One
next
is
five.
Four,
two,
three
deprecate
fingerprint
storage
use
the
extension
api.
Instead,
that
seems
reasonable.
It
needs
to
move
to
the
developer
section.
But
it's
oh,
oh,
except
we
like
to
put
the
word
developer
colon
at
the
front.
Don't
we
yeah?
C
A
It
it
that's
a
good
point,
it
should
be.
We
probably
should
convert
it
so
that
it
looks
like
java
code
and
looks
like
code
instead
of
instead
of
the
it
looks
like
a
javadoc
reference.
There
I
mean
we
could.
We
could
either
make
it
into
a
javadoc
reference
or
into
a
into
just
code.
A
Yeah
but
I
think
well,
oh
yeah,
good
point
right
so.
A
A
A
A
A
B
A
So
everybody,
okay
with
that
and
we'll
have
to
check
it
with
daniel.
It
will
need
a
separate
edit
later
add
references
for
the
fingerprint
storage.
A
It
does
yes,
finally,
okay,
good
all
right
next
6010
improve
logging
from
abstract
from
termination
of
cloud
agents.
Okay
to
me
that
looks
pretty
good.
Oh
except
we
don't
use
past
tense
right,
it's
supposed
to
be
present,
hence
so.
A
A
A
So
is
this
a
regression
yeah?
Well
it
yeah.
It's
a
regret.
It's
a
change
from
the
yes,
a
regression
from
the.
What
do
you
call
it
from
the
table
changes?
But
if
you
look
at
it,
I'm
not
sure
I'm
ready
to
highlight
it
as
a
regression.
It's
no!
It's
a
that
takes
a
very
fine
eye
to
detect
a
difference
there.
Let's
zoom
in
on
that
notice
notice
when
he
says
a
little
janky,
it's
really
hard
for
my
eye,
at
least
to
see
that
there's
any
change
there.
B
C
What
kind
of
changes
there?
Even
I'm,
not
able
to
see.
A
So
if
you
look,
he
says
there
are
strange
artifacts
in
the
corners
and
borders
between
rows
disappeared
and
I
think
the
strange
artifact
in
the
corners.
If
you
look
at
this
one,
it's
got
a
different.
Where
is
it
I'm
not
sure
I
can
get
close
enough
to
it.
It's
got
a
sort
of
a
more
white
little
bit
section
here
and
this
one
has
an
odd
shape
and
I
think
I
think
that's
what
he
means
when
he
says
a
little
janky.
D
C
B
A
A
Yeah
these
look.
These
look
like
cleanup
items
for
me:
dependency,
updates
and
clean
up
items.
So
it's
fine
that
they're
not
included,
and
what
do
we
mean
by
these
check
style
checks
because
there's
a
lot
of
them,
so
a
check
style
check
is
a
is
a
static
analysis
check,
that's
configured
to
look
at
the
formatting
or
the
text
of
the
source
code,
so
check
style.
Does
a
does
a
has
some
algorithmic
sanity
checks
that
it
applies
to
to
source
code
and
there
are
things
where
it
looks.
A
A
A
A
A
It's
also
like
like
for
from
meg's
and
my
as
origins
it's
like
the
lint
command.
A
Or
if
you're
more
recent,
it's
like
gcc,
warnoll
or
sealangs
worn
or
there
are
all
sorts
of
warning
warning
generators
that
will
help
you
try
to
write
better
code.
A
A
So
modernizing
a
plug-in,
the
blog
post
and
tutorial,
let's
spend-
or
are
you
okay?
If
we
spend
some
time
there
dhiraj-
and
I
had
time
during
last
week's
thursday
office
hours
to
talk
about
lts
and
lts
processes?
Are
you
okay?
If
we
take
this
topic
dhiraj
or
were
there
lts
related
things
that
you
wanted
to
discuss
further?
A
A
If
we
want
to
use
that,
I
was
mark
was
just
going
to
copy
copy
files
to
his
his
web
server
for
public
web
to
my
public
web
server,
and
I'm
okay
with
either
gavin's
will
probably
take
a
little
more
effort,
but
would
give
us
something
that's
much
richer
and
could
be
used
by
multiple
people.
A
B
A
A
A
Yep,
okay,
so
I
propose
to
put
it
at
that
location
and
right
now
that
location
is
not
useful
oops,
but
it
will
be
useful
reasonably
soon.
So
what
it
has
is
one
file
in
it
right
now,
but
I'll
put
more,
we'll
just
put
the
site
there
and
see
if
that
works,
cool,
okay,
so
the
the
more
important
thing
is
is
show
the
two
of
you,
the
kinds
of
things
that
are
in
the
document
now,
and
some
of
the
things
that
we've
we've
discovered
while
working
through
it
mistakes.
A
I've
made
things
like
that
that
are
are
good
things
for
us
to
be
sure
that
we
understand
particularly
dhiraj
as
you
and
I
are
working
together
on
this.
We
need
to.
I
need
to
clarify
the
things
where.
Oh
I
made
a
mistake
here,
watch
out
for
it,
so
the
the
live
stream
videos
are
still
very
useful
and
highly
effective.
We
absolutely
want
to
embed
those.
A
A
A
So
it
requires
requires
a
custom
check
style
definition
that
the
maintainer
agrees
is
useful.
Now
now
you
may
say:
well
wait
a
second.
We
just
did
this
review
of
a
bunch
of
polaroid.
We
saw
a
bunch
of
pull
requests
in
jenkins
core
that
are
using
check
style
right.
We
that
we
just
saw
those
and
it
mentions
those.
A
What
do
you
call
it
after
you've
adopted
it,
because,
after
you've
adopted
the
plugin,
then
yeah,
it
may
make
sense
you,
as
an
adopter
may
choose
which
check
styles
check
style
report.
You
want
to
enable
right.
A
B
Saying
don't
use
it
unless
you
get
with
the
maintainer,
you
know,
in
other
words,
define
a
custom
check,
style
definition
or
that
the
maintainer
agrees
on
before
using
check
style
reporting
or
something
like
that.
That's
rough.
A
Yeah
there
you
go
okay,
so
agree,
decide
with
the
maintainer.
A
B
A
And
and
that's
a
that's
a
good
hint,
I
would
say:
maybe
what
we
would
use
is
location
with
examples
of
effective
check,
style
rules
and
of
useful
check
style
rules
and
there
I
would
point
them
right
now-
use
jenkins
core
as
an
example,
because
it's
where,
where
basil
crowe
has
been
doing
example
work.
So
let's
put
a
hyperlink
to
it
and
we
will
just
that
way.
We've
got
it.
A
A
A
Now
the
challenge
is,
I
don't
know
how
to
search
for
that
text
in
a
hyperlink,
so
we'll
just
make
it
a
permalink
for
now.
Okay,.
B
A
Yeah
well
or
choosing,
which
ones
you'll
use
right
right
is
what
what
this
is
saying.
You'll
see
what
this
says
here.
It
says:
okay,
here
are
the
check
style
rules,
we're
going
to
do
line
length
for
any
file
that
ends
with
java.
We
want
lines
to
never
exceed
240
characters
and
we'll
ignore
certain
lines
that
are
known
to
have
tendency
to
be
long
right
right,
but
but
this
is
this
is
a
a
useful
example
of
hey.
Here
are
some
interesting
textile
rules
that
can
help
right?
A
You
remember
dhiraj
that
one
of
the
things
we
did
was.
Please
update
the
base
jenkins
version,
yes,
and
because
we
did
that
and
because
we
choose
a
version
2.289.1,
which
is
after
the
tables
to
divs
translation,
it
means
plugins
that
have
added
this.
These
conditionals
four
tables
to
divs
can
now
throw
them
away
because
they
now
say
I
no
longer
have
to
even
run
on
the.
I
can't
run
on
versions
older
than
this,
and
that
means.
A
A
A
This
one
is,
is
a
major
area
for
work
that
hey
it
doesn't
this
text
doesn't
nearly
describe
well
enough,
what
what
can
be
done
to
improve
online
help
for
pipeline
online
help
in
general,
but
especially
for
pipeline.
B
A
A
B
A
Okay,
so
there
is
a
thing
called
the
pit
mutation
framework
testing.
What
it
is
is
it's:
it
takes
your
tests,
it
takes
your
java
source
code
and
modifies
it
so
that
it
should
cause
your
test
to
fail
and
then
gives
you
a
report
telling
you
how
well
your
your
test
did
at
detecting
the
injected
failures.
A
A
A
A
All
right
well,
so
I
think
I've
been
through
the
ones
that
were,
on
my
mind,
diraj,
were
there
any
of
these,
where
you
feel
like
hey,
you
would
like
to
take
one
or
two
of
these
and
and
describe
them
further.
I
I've
got
to
get
started
writing
on
this
again.
I
haven't
touched
my
my
commits
for
for
weeks,
and
I
need
to
get
just
make
more
progress.
C
Yes
same
here,
so
I
don't
have
much
question
so
I
just
want
you
to
know
that
you
were
mentioning
this
person
john,
who
pointed
out
these
things
like
so
is
he
written
with
jenkins
or
and
how
did
he
find
out
about
this
draft.
A
A
As
soon
as
we
get
new
things
here,
sure
great,
okay
and-
and
that's
me-
is
I've-
got
I've
got
discussed
the
changes
and
what
we've
learned,
I
guess
there
is
there's
there
is
one
more
thing
that
well
it's
it's
related.
A
D
A
C
B
D
B
D
B
A
B
B
B
A
A
B
A
A
B
So
should
the
the
check
stuff
be
under
the
maintainer,
it.
C
A
That's
the
reason,
the
reasons
the
opinions
differ
about
it
is
because
there
are
people
who
correctly
say:
don't
you
dare
enable
that
on
my
on
the
thing
I
maintain
it's
too
noisy,
I
do
not
want
to
waste
time
addressing
its
non-useful
reports.
A
B
A
A
Oh
okay,
yeah
yeah,
that
would
yeah
see,
I
think
I
think
jesse
jesse
glick's
argument
was
hey,
he's
not
even
sure
that
people
should
bother
using
check
style,
okay
and
and-
and
I
think
it's
a
valid-
it's
a
valid
concern,
because
there
are
things
that
can
be
quite
wasteful
in
the
output.
If
you
have
to,
if
you
waste
time
worrying
about
code
formatting
that
is
irrelevant
to
you
as
a
maintainer,
you
you've
spent
time
on
something
that
didn't
help.
You.
B
Should
I
def
and
if
I
want
to
say
I
don't
do
like
for
you
mark
if
I
looked
at
the
get
plug-in,
where
would
I
know
that
you
had
deliberately
decided
not
to
use
this.
B
A
And
maybe
what
that
is
is
list
the
static
analysis
that
is
used
and
note
the
static
analysis
that
is
intentionally
not
used
right.
Oh
and
now
you
remind
me,
there's
there's
one
more
thing
which
we
should
have
put
in
there
and
I
never
did
and
we've
got
a
video
on
it
and
everything
it
is.
B
B
A
B
A
B
A
B
A
C
Even
I
tried
that
blog
post,
where
we
interact
with
the
plugin,
why
make
a
plugin
with
hello,
hello,
world
right
right,
so
this
would
definitely
be
very
helpful
to
them.
B
That,
first
one
under
documentation
is
that
complete
I
mean
if
I'm,
if
I
make
my
doc,
if
I
put
my
documentation
in
the
readme
of
my
source
code,
I
have
my
documentations
under
github.
There's,
there's.
A
A
Where
is
it,
you
create
the
documentation?
Where
is
the
mention
of
palm.xml?
Oh,
that's
shameful!
Oh
dear
okay,
so
this
needs
fixing.
This
page
only
tells
half
the
story.
So
this
talks
about
how
you
migrate
it.
That's
there's
got
to
be
another
page
that
talks.
A
B
A
D
A
Okay,
plugin
wiki
pages
page
describes
non-uh
outdated
steps.