►
Description
In this issue Jean mumbles to himself while he refines the issues relating to converting the GitLab handbook from Middleman to Frontman.
A
Hello,
everybody,
the
static
site,
editor
issue,
refinement
session.
Today,
I'm
going
to
be
releasing
the
file,
I'm
defining
the
issue
of
migrating
from
middlemen
to
frontman.
On
our
handbook,
we
some
context.
A
We
became
aware
of
the
frontman
project
a
few
months
ago,
things
to
romantically
or
bring
us
onto
it
and
back
then
it
wasn't
public.
Yet
it
was
developed
by
the
documentation
team
at
algolia
who,
similar
to
us,
was
using
middlemen
as
they
static
site
generator
and
random,
similar
to
us
into
performance
issues
and
went
on
a
journey
of
creating
their
own
stack
site
generator,
and
so
we,
I
had
a
look
at
their
video.
I
was
reminiscing
put
us
in
touch
long
story
short.
A
We
got
in
touch
they've
recently
released
an
alpha
version
of
it
and
we
are
hoping
to
migrate
for
the
handbook
specifically
now
that
we've
split
the
marketing
and
web
handbook
website
into
their
own
sites,
primarily
in
the
mono
request
structure.
There's
still
some
shared
assets
that
we're
going
to
work
to
move
away
from,
but
overall
the
risk
of
trying
to
at
least
migrate
to
frontline
is
low.
And
from
that
point
of
view-
and
you
know-
hopefully
it
can
bring
with
it
a
lot
of
performance
benefits.
A
Some
of
the
benchmarks
out
there
seem
to
indicate
a
five
x
improvement
in
generation
department.
That's
certainly
could
be
handy
in
terms
of
our
pipelines,
so
I'm
going
to
share
my
screen,
so
you
all
can
follow
along.
A
All
right,
so
one
of
one
of
the
key
things
about
frank
men
is
that
it's
inspired
by
middlemen
and
essentially
follows
a
lot
of
the
same
structures.
A
So
while
it's
not
exactly
a
dropping
replacement
for
middlemen,
it's
it's
close
enough
that
you
know
the
algolia
team
converted
their
whole
site
to
frontman
in
three
days
and
they've.
They've
got
a
large
site
with
thousands
of
pages,
and
you
know
my
handbook
site
is
now
8
000
pages
chad,
that's
an
initial
kind
of
like
exploration,
and
one
of
the
first
things
that
we
need
to
do
is
move
away
from
custom
extensions.
That
middleman
allows
you
to
write
in
favor
of
using
helpers.
A
Frontman
does
not
support
custom
extensions,
but
they
do
have
helpers
and
based
on
initial
kind
of,
like
exploration,
doesn't
seem
like
this.
Anything
we
can
do
is
by
moving
to
helpers
instead
of
custom
extensions.
So
there's
a
problem
with
a
bit
of
a
discussion
about
it
and
so
there's
obviously,
some
prerequisites
that
we
need
to
do
in
terms
of
inverting.
The
existing
code
base
to
be
ready
to
even
attempt
the
conversion
to
the
front
brake.
A
So
what
I'm
going
to
do
today
is
just
refining
this
kind
of
like
issue
that
says
you
know
migrate,
gets
that
handbook
from
middlemen
to
franklin
and
what
I
really
want
to
do
is
actually
start
by
converting
this
to
an
epic,
because
we
can
house
a
whole
bunch
of
issues
between
it.
A
Let's
promote
this
in
epic,
let's
ping,
the
polish
labels.
A
And
that's
fine
like
that,
and
we
probably
want
to
hook
it
up
to
our
top
level,
epic
as
well
so
yeah,
okay,
we've
got
an
ancestor
already
here.
Well
that
wasn't
clever
for
me,
it
seems
like
we
already
had
an
epic
for
it.
A
So
maybe
what
I
should
do
is
sort
of
close
that
onto
another
as
far
as
this
one
and
go
back
to
the
old
issue
and
open
it
up
again,.
A
Top
level
one
all
right,
so
thank
you
eric!
We
miss
that
you
already
had
a
previously
fleshed
out
epic
for
us,
so
one
of
the
things
that.
A
One
thing
that
I
really
shared
previously
is,
if
we
go
into
the
extensions
we
currently
have
here,
have
a
bunch
of
them
that
are
specific
to
the
monorepo,
as
well
as
the
assets
that
we
that
we
have
shared
between
kind
of
like
the
the
handbook
in
the
marketing
site.
You
know
the
partial
build
that
we're
using
in
the
handbook
anymore.
A
Essentially,
the
two
two
main
functional
ones
that
we
need
to
create
helpers
for
instead
of
extensions,
is
breadcrumbs
and
code
owners
and
then
also
we
can
need
a
mono
repo
kind
of
like
a
patch
for
front
mount
which
will
help
to
contribute
up
to
upstream
to
enable
the
mono
reboot
structure
that
we
have
so
the
first
one
I
want
to
do
is
an
issue
for
the
brake
forms.
A
A
Something
went
wrong.
That's
obvious!
Right
now,
something's
going
on
here
status,
500,
instrument.js,.
A
Let's
just
read
that
quickly:
well,
that's
unfortunate
nice
just
office
this
battle
quickly,
so
it's
not
breaking
still
sleeping.
A
A
A
So
we
need
to
convert
this
this
one,
this
one,
we
need
to
add
mono
ripple
support,
and
then
we
need
to
migrate
the
handbook,
so
that
I
think,
gives
us
a
good,
including
the
prerequisites
until
you
can
actually
get
to
the
migration.
A
All
right,
so,
let's
start
by
fleshing
out
this.
A
A
A
A
A
A
More
feature
that's
moving
to.
We
don't
really
need
this
feature.
You
know
we
don't
have
those
script.
A
A
A
I
will
say
that
something
all
risky
in
a
sense
of
you
know
we're
doing
a
bunch
of
work
to
and
then
we
might
not
end
up
migrating
to
frontline
chad
that
initial
kind
of
flight
wanted
validation
and
you
know
everything
seemed
feasible,
and
so
the
risk
we're
taking
is
a
measured
risk.
So
that
should
be
fine.
Let's
talk
about
him
from
library
to
reference.
A
A
It's
to
be
very
vague
intentionally,
as
I
don't
have
all
the
technical
details,
that's
mostly
in
chad's
mind
and
so
I'll.
Let
him
flesh
this
out,
but
just
get
the
ball
rolling,
so
proposed
solution
is.
A
A
A
A
Now,
considering
all
the
other
work
on
our
that
we've
planned
for
13.4,
it's
unlikely
that
I
will
get
more
than
the
migration
of
the
helpers
and
monitor
express
for
intel
front
fan.
What
I
do
have
looked
in
is
leave
this
as
13.4
for
now,
but
it's
likely
this
one.
We
read
move
over
to
35.
I
just
want
to
see
if
there's
anything
we
wanted
to
migrate
around.
A
So,
firstly,
the
first
step
on
our
version
is
convert
existing
custom,
the
other
one
extension,
okay,
upper.
A
A
Is
all
right,
so
we
are
only
going
to
touch
the
handbook
site.
I
think
one
of
the
things
we
also
want
to
do
as
part
of
this
is
fully
break
it
completely.
A
So
currently
we
we
did
have
some
shared
assets
in
this
in
the
sense
of
images,
styling
scripts
and
also
even
partial
templates,
that
is
shared
between
the
handbook
and
the
marketing
site
and
considering
the
journey
that
the
marketing
team
is
on,
as
well
as
the
journey
we're
on
it's
going
to
be
important
that
we
break
that
up,
even
though
it's
loosely
defined,
I
guess
at
this
stage
we
need
to
break
that
going
forward.
It's
just
going
to
cause
more
trouble
than
to
work,
even
if
it
means
duplication
in
the
thought
all
right.
A
Mr
we've
tossed
that
shad
outlined,
maybe
that's
worth
being
into
this
as
well,
but
let's
see
I
want
to
link
this
one
to
the
epic
8
000.
A
Might
be
worth
having
these
as
some
issues,
but
let's
get
ahead
of
ourselves.
A
A
A
A
A
A
Let's
see
if
I
can
find
this
all
those
labels
are
gone.
A
A
All
right,
I'm
going
to
solve.
Okay,
even
though
the.
A
Okay,
we
still
have
some
inserts
just
lost
your
powershot.
A
A
A
A
A
There's
not
easy
way
to
share
things
that
any
we
have
a
way
of
sharing,
but
it's
very
cumbersome
and
then
from
moving
away
to
front
men
can
be
even
worse
to
keep
that
as
well
as
the
direction
you
want.
Besides
very
good.
So
the
first
solution
is
we
copy
from
the
current
shared
assets.
A
So
essentially,
what
we'll
end
up
with
is
most
of
the
shared
assets
is
probably
related
to
the
marketing
site.
It's
going
to
be
corrected
on
that
point,
but
I
feel
fairly
confident
in
making
that
statement,
and
so
I
think
it
makes
sense
to
just
say:
look
remove
everything
there
and
from
there
you
can
do
a
clean
up.
A
So
we
do
pretend
we
appreciate
ourselves
only
what
is
needed
by
the
handbook
into
the
handbook
by
directory
leaving
you
know
the
ending
depend
and
see
on
any
file
outside
of
this
directory.
A
A
A
A
A
A
All
right
this
one,
I
definitely
want
to
cc
ballroom
and
I
have
all
them.
A
A
Okay,
let's
make
sure
to
include
laura
and
diamond
and
that
probably
a
chat.
A
But
considering
the
context
and
where
we're
heading,
I'm
sure
he'll
come
around
to
see
my
way
on
this
one.
This
is
the
hammer
approach
rather
than
the
surgeon
approach,
but
if
we
try
and
comb
for
everything
now-
and
it
just
feels
like
a
a
hard
problem
to
solve
that,
we
could
rather
do
this
okay
right.
So
if
we
go
back
to
our
epic
here,
refresh
make
sure
it's
everything
we
need
to
completely
decouple
the
handbook
from
market
size
car.
A
So
all
of
these
decoupling
converting
as
well
as
so
these
four
things
here
can
literally
happen
in
parallel,
so
we
can
have
any
team
who
picked
this
up.
This
one
is
obviously
dependent
on
these
getting
into
place.
So
that's
one
of
the
nice
things
that
we
can
share
the
load
here
and
then
once
that's
all
in
place
and
chat
can
run
with
this
one,
I'm
very
happy
with
what
we
have
here
and
I
think
yeah.
This
seems.
A
I
think,
we've
moved
it
forward,
refining
in
the
issues
and
adding
more
steps
and
so
on.
So
I
think
that
should
be
enough
for
today.