►
From YouTube: GitLab Docs Offline - R&D Requirements Discussion
Description
Discussion to get the context around the requirement for offline docs and which direction we should go in with R&D.
A
Right,
hello,
everybody!
So
this
is
a
quick
synchronous
discussion
to
have
a
look
at
the
need
to
or
the
desire
to
provide
the
offline,
docs
version,
and
so
we're
just
going
to
brainstorm
a
few
ideas
and
determine
the
next
steps
on
what
we
want
to
do.
With
regards
to
an
r
d
spike
to
see
what
the
best
solution
you
would
be
going
forward,
jog
for
over
to
you
to
give
us
some
context.
C
B
Cool
okay,
so
let
me
just
quickly
take
you
through
some
of
the
differences
between
the
docs.gitlab
static
website
and
the
gitlab.com
forward.
Slash
help
before
you.
A
Actually,
no
there's
a
there's:
a
percentage
drop
down
there,
no
they're
they're,
making
their
heading
drop
down
and
there's
100
gallons
yeah
yeah,
maybe
maybe
try
150.
B
B
And
then
the
documentation
for
all
the
gitlab
ins
applications
gets
hosted
on
the
gitlab.uh
docs
docs.hitler.com
project,
so
this
includes
git,
lab
runner,
omnibus
charts
and
all
of
the
other
applications,
and
it
also
supports
multiple
versions.
So,
on
the
docs.gitlab.com
project,
there's
just
drop
down,
we
can
choose
different
versions.
B
It's
also
feature
rich
and
well
maintained
for
the
most
part
and
then
looking
over
at
the
gitlab.com
forward,
slash
help
section
that
contains
all
of
the
help,
all
of
the
markdown
content
that
you
find
in
here.
For
that
specific
instance,
the
problem
is
that
it
lacks
the
features
of
darkstarkgitlab.com.
B
B
So
the
biggest
problem
is
that
this
help
section
doesn't
look
anything
like
the
gitlabs.com
website
and
okay.
B
So
the
main
problem
is
that
the
gitlab
a-gap
instances
use
they.
They
only
use
this
section
for
getting
help
for
the
application,
but
obviously
they
want
all
the
ux
and
nice
to
haves
of
the
gitlab
docs
project.
B
A
B
Yes,
so
so
the
docs.gitlab.com
project
is
a
static
website,
so
all
of
the
all
of
the
markdown
files
gets
pre-compiled
into
html
before
it
gets
served,
but
github.com
forward
slash
help
section.
As
far
as
I
understand
it
gets
rendered
on
the
fly
by
some
ruby
controller.
A
B
C
B
B
So
we
need
to
find
a
way
to
unify
the
two
so
that
they
both
have
the
same
features
at
the
end
of
the
day.
That's
the
biggest
problem
for
us
to
solve,
and
then
looking
at
the
issue
there
there's
already
some
ongoing
discussion
in
there
and
two
possible
solutions
came
out
of
that.
B
B
The
other
solution
is
to
update
the
methods
for
building
the
help
section
to
more
closely
in
line
with
that
of
the
dark
side
kit
lab
project,
so
that
there's
more
features
between
the
two,
for
instance.
We
we
can,
for
instance,
pull
master
of
gitlab
docs
into
gitlab
and
serve
it
in
a
different
port.
A
Yeah,
just
so,
essentially,
the
the
problem
is
we're
maintaining
two
different
trying
to
maintain
two
different
things,
but
the
main.
The
main
intention
of
this
is
to
provide
the
documentation
in
an
offline
environment
where,
in
an
air
gap
solution
where
there's
no
access
to
the
to
the
internet,
and
they
can't
access
docs.github.com
that
they
can
at
least
access
a
version
of
the
documentation
on
their
network.
That
is
fully
featured.
B
That's
right,
that's
right,
so
there's
also
so
that
that
is
a
big
concern,
but
looking
at
the
issue,
we've
also
got
some
concerns
of
our
own.
For
instance,
currently
the
forward
slash
help
section
doesn't
give
us
the
ability
to,
for
instance,
do
includes
redirect
and
search,
whereas
the
docs.gitlab.com
project
gives
us
those
abilities.
B
C
B
B
A
A
B
A
Yeah,
okay,
so
I
I
guess
from
a
search
point
of
view.
My
first
question
is:
can
you
host
an
algolia
instance
yourself,
or
is
it
only
online?
Is
it
only
like
a
sas
offering?
A
Because,
if
we're
using
search
for
for
you
know-
and
it
requires-
you
know
like
an
online
connection-
and
they
don't
have
an
ability
to
to
host
an
instance
yourself,
but
which
is
also
you
know,
I
guess
would
be
difficult,
because
you
probably
need
to
pay
to
host
an
instance
yourself
and
all
those
kind
of
things.
A
So
the
search
part
is
potentially
a
big
deal
breaker
from
just
in
terms
of
the
way,
the
docs
that
gitlab.com
works
right
now,
which
is
a
static
site
that
gets
generated
and
then
having
that
in
offline
environment
and
providing
search
will
be
really
tricky.
Which
is
why
I
guess
the
the
concept
of
expanding
help
hasn't
been
taken
off
of
the
table,
because
that
gives
you
a
back-end
run
time,
at
least
that
you
can
use
for
dynamic
features.
B
Yeah
yeah,
that's
right,
and
one
of
the
outcomes
from
this
r
d
session
is
to
obviously
expose
things
like
this
and
to
break
it
down
into
into
deliverable
chunks.
So
I
would
imagine
that
search
would
be
one
of
the
things
that
we
need
to
split
out
into
separate
issues
that
we
can
properly
investigate
that
and
possibly
do
some
spikes
around
it.
B
First
yeah
so
yeah,
so
the
purpose
of
the
r
d,
like
I
mentioned,
breaking
it
down
into
into
deliverable
chunks,
but
also
mainly
building
knowledge
in
the
domain
and
proposing
solutions
or
expanding
on
existing
ones
and
also
just
answering
the
question
whether
or
not
we
would
need
help
from
the
pages
team
it
it
may
very
well
be
that
this
is
a.
B
This
is
a
feature
that
the
pages
team
would
need
to
take
over.
But
that's
always
gonna
be
your
answer.
A
So
with
that,
you
mean
the
like,
for
instance,
how
you
can
post
your
a
static
site
with
a
on
in
gitlab
on
a
project
kind
of
thing.
A
A
I
feel
like
the
non-negotiables
are
almost
the
thing
that
needs
to
be
defined
to
to
be
able
to
to
know
which
direction
to
look
into
if,
for
instance,
search
is
a
non-negotiable
thing,
and
also
if
we,
if
we
do
go
down
the
road
of
making
help
more
feature
rich
and
stuff,
you
know
like
how
do
we?
How
do
we
share
the
effort
across
the
two
projects
so
that
we
don't
end
up
having
to
maintain
two
separate
systems
as
much
as
possible?
A
A
Is
you
know
having
to
keep
in
mind
it's
it's
like
when
we,
when
we
had
the
c
and
e
separate
repos,
you
know,
and
and
we
had
to
duplicate
things
across
and
so
on,
so
which
is
not
ideal,
so
yeah,
maybe
yeah,
maybe
maybe
the
the
I
guess
the
the
end
result
is
maybe
not
having
a
dark
side
git
laptop
project
in
some
way,
maybe
just
having
the
the
documentation
part
of
gitlab
in
gitlab
and
having
having
that
as
an
output,
be
able
to
be
posted
on
docs.gitlab.com
from
an
output
point
of
view.
A
C
So
yeah,
I
actually
agree
with
the
that,
having
like
two
separate
projects,
it's
not
a
great
idea
because,
like
right
now
we
have
one
which
is
actively
developed,
another
one
which
is
maintained
on
real
low
level,
and
we
have
this
difference
between
the
features
and
even
if
we
fix
the
gitlab.com
help
and
provide
some
extra
features
to
eat,
it
will
be
still
a
problem.
You'll
need
to
constantly
maintain
return
back
and
update
it.
So
I
guess
the
right
approach
would
be
to
aim
for
one
single
project
that
we
can
share.
C
We
can
probably
use
to
have
like
dogs
only
or
to
have
a
dogs
included
into
the
gitlab,
like,
I
think
it's
up
to
us
to
decide,
but
for
that
I
think
we
need
to
figure
out
like
how
much
effort
we
need
to
do
to
achieve
like.
I
guess
our
goal
is
to
have
dogs
that
users
can
use
off
the
line
without
internet
connection
and
the
docs
that
have
like
lots
of
features
that
we
want
to
provide
as
well.
B
Yeah
and
obviously
yeah
sorry
go
for
it
all
right.
I
just
want
to
say
obviously
having
having
to
maintain
just
one
code
base
could
be
the
ideal
outcome
yeah,
because
it's
getting
it's
getting
more
and
more
complicated
to
try
and
maintain
these
two
different
versions
of
our
docs
or
docs
ui.
So
I
think
the
ideal
outcome
would
have
whether
we
include
it
in
the
gitlab
project
or
still
have
it
as
a
separate
project
and
then
package
it
within
the
gitlab
project.
C
So
what
if
we,
for
example,
take
the
docs
gitlab
as
a
example
as
a
base
and
you'll
try
to
add
this
offline
search
to
it
and
somehow
ship
it
together
with
the
gitlab
product
too.
So
we'll
use
the
most
modern
version
of
our
docs
one
side,
so
we
don't
need
to
implement
it.
We
just
need
to
add
the
features
that
it's
missing
right
now.
B
A
A
Far
as
as
far
as
I
know,
they're
only
indexing
groups
and
projects
and
stuff
in
in
the
elasticsearch
database
so
we'd
have
to
work
with
the
search
team
to
to
see
if
it's
possible
to
to
index
the
documentation
as
well,
because
yeah.
If
we
have,
I
mean,
we've
got
a
search
functionality
in
gitlab
and
and
so
if
we
can
include
the
documentation
as
part
of
the
search
results.
That
would
be
really
useful.
C
B
So
for
the
first
iteration
we
by
excluding
the
search
capabilities
of
the
docs,
we
actually
won't
be
losing
any
features
yeah,
but
I
think
we
should
still
enable
the
search
functionality
on
the
online
version.
What
about
what.
A
And
then
also,
I
would
imagine
that
the
aversion
drop
down
wouldn't
be
necessarily
appropriate,
because
you'd
want
the
documentation
relevant
to
to
to
the
version
that
you're
running
on
that
instance.
So
it's
not
as
simple
as
just
I
guess,
replicating
what
what's
in
docs
on
docs.gitlab.com
and
putting
it
in
the
in
the
help
site.
A
Finding
some
sort
of
mechanism
to
share
resources
between
the
two
like
layouts
and
styling
and
stuff
might
might
be
another
approach
that
we
that
we
that
we
look
at
you
know.
Maybe
we
could
have
a
package
that
that
has
the
shared
common
common
things
between
the
two.
You
know,
I'm
not
sure
you
know
yeah,
because
it's
not
a
it's
not
as
clean
cut,
as
just
you
know,
replicate
gitlab.com.github.com
functionality
to
help.
There
is
some
tweaks
that
would
need
to
be
made.
B
Yeah
yeah,
I
agree,
and
so
obviously
bringing
the
gitlab
project
into
gitlab
and
having
all
the
content
displayed
under
the
same
domain
is
one
solution,
but
the
other
solution
is
to
redirect
them
to
a
different
port
altogether
when
they
go
to
the
help
section.
B
B
A
Think
I
think
we're
the
requirement
of
what
needs
to
be
visible
on
help
really
dictates
which
route
we
want
to
go,
because
if
they
want
to
have
all
the
the
documentation
from
the
others
projects
as
well
like
runner
and
so
on,
because
I
could
imagine
that
runner
having
run
your
documentation,
it
would
be
helpful
and
stuff
like
that.
A
C
B
Yeah,
so
there's
definitely
different
ways.
We
can
approach
this
and
I
think
this.
This
is
probably
where
a
lot
of
our
work
would
also
lie
in
in
this
r
d
phase,.
A
So,
for
me,
what
it
feels
like
is
the
first
step
is
just
to
clarify
on
the
exact
requirements,
because
the
requirements
might
short
circuit
some
of
the
effort
we
might
need
to
put
into
to
see.
You
know
how
do
we
share
layouts
and
styling
between
help
and
docs.google.com
and
all
those
things,
because
if
the
requirements
become
clear
enough,
we
had
said
you
know.
Actually
we
need
a
full
featured
docs
thing
available
offline.
A
So
I
I
think
the
the
first
step
before
we
put
real
cycles
into
research
and
stuff
is
is
clarifying
the
the
the
requirements
so
almost
like
out
on
that
issue
that
that,
for
those
you
know
like
summarizing
the
requirements
and
and
having
the
the
various
stakeholders
confirm
that,
yes,
this
is
the
requirements
or
no,
you
know
we
can
do
without
this,
and
so
on,
like
what
is
the
core
minimum
requirements
and
what
is
nice
to
have
on
on
this?
B
C
B
Makes
sense
so
yeah,
I
think
we,
the
next
step
it
sounds
like
we
could
probably
pose
some
of
the
questions
that
came
out
of
the
session
in
the
issue,
just
so
that
some
of
the
stakeholders
can
can
give
us
some
clarity
on
that
before
we
go
down
down
a
specific
route.
C
B
Okay,
that's
right!
So
during
the
process,
the
docs
project
pulls
all
of
the
all
of
the
content
in
this
folder.
B
And
then
it
generates
the
static
pages
from
the
from
the
markdown
files
in
this
folder.
Does
that,
like
you
said
this
is
the
source
of
truth
for
the
docs
content,
yeah.
A
Was
on
it,
what
might
be
helpful
is
if
you
we,
you
know
if
you
follow,
if
you
check
out
the
docs.gitlab.com
project
and
you
follow
the
installation
instructions
to
get
it
running
locally,
you
get
a
really
good
feel
for
how
it
works,
to
get
it
going
where
it
literally
all
the
repos.
It
pulls
the
various
docs
sections
of
those
repos
in
and
then
at
both
times.
It
uses
that.
A
Would
they
want
the
runner
documentation
on
help
and
all
of
those
kind
of
things
as
well
to
you
know
like
do
they
wanted
fully
fledged
fledge
docs.gitlab.com
in
an
offline
environment,
or
is
it
only
for
the
gitlab
product
you
know
and
if
they
need
help
for
runner,
would
they
be
in
a
different
upfront,
slash
for
instance,
so
having
a
clear
understanding
of
those
requirements
really
differentiates
between
which
way
we
go
with
the
r
d
cool.
B
Cool
so
yeah
I
can
pose
as
questions
in
the
issue
for
us
and
then
maybe
we
can
have
a
follow-up
session
once
we've
got
some
clarity
on
that.
A
All
right
that
makes
things
I'll
upload
the
this
recording
to
gitlab
unfiltered
as
well.
If
anybody
from
the
docs
wants
to
reference
our
conversation
and
questions
to
get
some
more
context,.