2:50 p.m.
On Wed, 2021-01-27 at 13:44 -0800, Karsten Wade wrote:
There are also some web designer skills needed around styling the
Asciidoc output, including building a multi-page website for the HTML
version (perhaps generated by Antora?).
Shaun—what skill gaps do we have around the various book rendering
tools?
I'm going to try to bullet point skills people could bring. I have
varying levels of experience across these points, but I don't need to
own any of them if others are eager.
* Visual style work. Document design is related to but distinct from
graphic design. I have some experience, and I put together a draft of a
start of a visual identity. I'll remind the crowd that I am red-green
colorblind, so I always copy color palettes from others, and even then
I might mess up.
* CSS work to implement the visual style in HTML. I do this kind of
thing often enough.
* Asciidoctor experience to make sure our CSS and whatever else is
smoothly fits into how docs are generated, and aren't hacks on top.
* Work with asciidoctor-pdf (and possibly the underlying renderer
Prawn) to implement our style. I have some print experience, but it's
old, and tools are new. I can figure it out, but I have to yell at
clouds first or something.
* Site publishing/orchestration work. Is Antora the answer? Maybe,
maybe not. But different pieces of the site come from different places,
and there's not a clean publishing story.