Status of help.gnome.org and Pintail

[Shaun McCance <shaunm gnome org>]

Folks,

I've been off-and-on working on retooling help.gnome.org using Pintail,
the documentation publishing platform built for Mallard and Ducktype.
I'd like to get this finally finished. I could use help.

Here is a current preview:

https://people.gnome.org/~shaunm/help.gnome.org/

Here is the repo that builds it:

https://gitlab.gnome.org/Infrastructure/help.gnome.org/

The README is up to date, I believe.

Pintail builds from git, not tarballs. A full site rebuild without
translations takes about 6 minutes for me, which includes the time it
takes to git pull. With translations, it takes about 3 hours. If run in
containers without persistent storage for checkouts, it could take much
longer for all those git clones. It's possible to do partial rebuilds,
but there are things to be aware of that I won't get into in this
email.

Things remaining to do:

* I hacked together the style. I think it looks ok. People who live web
design can probably do better.

* There's no site search right now, but this is something Pintail is
designed to support (and support really well). The existing search
plugin uses Elasticsearch, which is problematic. We need a new plugin
based on OpenSearch, Apache Solr, or something else. I mostly know how
to do this, but I'm having a hard time finding the bandwidth. We can
launch without this, but I'd be sad.

* Petr, David, and I had a long conversation about publishing old
versions and decided against it. You have those locally installed. We
can revisit this if people want.

* Speaking of which, the URL format is vastly simplified. Instead of
/users/gnome-help/stable/, it's just /gnome-help/ for the core GNOME
help. This means we need to set up a .htaccess with redirects. I'd very
much like to have this as a Pintail feature, if someone wants to do
some Python. But we can also just hand-write a .htaccess file.

* We did decide on publishing an unstable preview for select documents.
These all live under /unstable/. We need a robots.txt so that El Google
never ever ever lands people there. I'd very much like to have this as
a Pintail feature, if someone wants to do some Python. But we can also
just hand-write a robots.txt file.

* We have to actually deploy it somewhere other than my personal space
on people.gnome.org. This will take involvement from our admins, of
course, but also on our part to see things thru.

* (Preview of what I'm going to talk about in my GUADEC presentation:
I'd like to rename the site to learn.gnome.org and start to shift our
focus toward learning-based material.)

--
Shaun