For those who attend our regular (PMC-only) video calls, they might recall
I had already pitched the idea of re-doing (not redesigning!) the website
many times. As a matter of fact, with a group of volunteers from the 12th
meeting (Christian, Piotr, and I), we even fleshed out a draft of the
structure
<https://docs.google.com/document/d/10Fu7oqDzdM_D6LbexzwX9arh51Tic7AGvkWTQrL6jjQ/edit>.
I find it crucial to use a tool that will enable us to realize this
structure with following concerns in mind:

   1. Content type setting needs to be developer-friendly and future-proof
   (read as *"it must be AsciiDoc"*)
   2. It needs to support a multi-repository setup that we will proceed
   with (AsciiDoc and multi-repo? Antora <https://antora.org/>!)
   3. It needs to support templating (Antora)

Intersecting these constraints with available solutions in the market
yields not much but Antora, hence my push for that.

> preliminary sketches

Obviously I would want nothing but an Antora template composed of
ASF-compliant (CSS, JS, etc.) files.

> dynamic content

I don't see a need for that. Mind sharing for what purpose? (BTW, Antora is
a static site generator.)

> a nice Search feature

Antora has built-in search support.

> configuration validation tool

I talked about this with Piotr earlier, that is a great idea. Though the
PoC can simply be throwing users' configuration to xml.js
<https://github.com/kripken/xml.js/> for validation against the Log4j XSD.

> What JS library

None preferably.

On Fri, Aug 4, 2023 at 10:53 PM Piotr P. Karwasz <piotr.karw...@gmail.com>
wrote:

> Hi all,
>
> Since our website has seen better times, I asked a young designer,
> Daniel Żabiński, to freshen it up a little bit.
>
> The preliminary sketches are available at:
>
>
> https://xd.adobe.com/view/455b5d92-d89b-45d9-984c-871974460249-1008/?fullscreen
>
> Personally I like the way it looks and I think we should implement it.
>
> This brings a lot of technical questions like:
>  * do we even care about Maven Site skins or should we use a different
> static site generator?
>  * Daniel proposes a nice "Search" feature, which technology can we
> use on a statically generated site?
>  * can we have some dynamic content backed up by Apache infrastructure?
>  * In the near future we'll be implementing a configuration validation
> tool. I would like to use the same Javascript library for both the
> tool and the rest of the website? What JS library would you propose
> for interactive content.
>
> Piotr
>

Reply via email to