public inbox for linux-doc@vger.kernel.org
 help / color / mirror / Atom feed
From: Jonathan Corbet <corbet@lwn.net>
To: Rito Rhymes <rito@ritovision.com>,
	skhan@linuxfoundation.org, mchehab@kernel.org
Cc: linux-doc@vger.kernel.org, linux-kernel@vger.kernel.org,
	Rito Rhymes <rito@ritovision.com>
Subject: Re: [PATCH] docs: generate a static 404 page
Date: Mon, 30 Mar 2026 09:53:48 -0600	[thread overview]
Message-ID: <87zf3pnwj7.fsf@trenco.lwn.net> (raw)
In-Reply-To: <20260329180448.24614-1-rito@ritovision.com>

Rito Rhymes <rito@ritovision.com> writes:

> Broken links in static deployments currently fall back to a
> generic web server 404 page, which leaves users on an orphaned
> error page with no direct way to continue navigating the
> documentation site. Add a dedicated not-found page so deployments
> can serve a project-specific 404 instead.
>
> It keeps the normal documentation layout around the error state so
> users still have the search box, table of contents, footer links,
> and a clear route back to the documentation root. The penguin
> logo makes it less generic and adds character to what is
> otherwise a frustrating page to encounter.
>
> For translated documentation, generate 404 pages whose return
> link keeps users inside the current translation instead of always
> sending them back to the English root documentation.
>
> Actual 404 handling remains a web server concern.
>
> Signed-off-by: Rito Rhymes <rito@ritovision.com>
> Assisted-by: Codex:GPT-5.4

I don't think that this makes a lot of sense.

Who are your users, what is your use case?  Who do you think will do all
of the setup work to create a server with a custom 404 page, but can't
supply the page itself?

This is the kernel documentation, not a web-site construction kit.

Please slow down and think about solving real problems.  There is So
Much Work that needs to be done with the kernel documentation, but none
of it has to do with this stuff.  And, in any case, the merge window is
approaching, so significant changes will not be accepted at this point
even if they otherwise make sense.

Thanks,

jon

  reply	other threads:[~2026-03-30 15:53 UTC|newest]

Thread overview: 5+ messages / expand[flat|nested]  mbox.gz  Atom feed  top
2026-03-29 15:20 [PATCH] docs: generate a static 404 page Rito Rhymes
2026-03-29 16:54 ` Rito Rhymes
2026-03-29 18:04 ` Rito Rhymes
2026-03-30 15:53   ` Jonathan Corbet [this message]
2026-03-30 17:20     ` Rito Rhymes

Reply instructions:

You may reply publicly to this message via plain-text email
using any one of the following methods:

* Save the following mbox file, import it into your mail client,
  and reply-to-all from there: mbox

  Avoid top-posting and favor interleaved quoting:
  https://en.wikipedia.org/wiki/Posting_style#Interleaved_style

* Reply using the --to, --cc, and --in-reply-to
  switches of git-send-email(1):

  git send-email \
    --in-reply-to=87zf3pnwj7.fsf@trenco.lwn.net \
    --to=corbet@lwn.net \
    --cc=linux-doc@vger.kernel.org \
    --cc=linux-kernel@vger.kernel.org \
    --cc=mchehab@kernel.org \
    --cc=rito@ritovision.com \
    --cc=skhan@linuxfoundation.org \
    /path/to/YOUR_REPLY

  https://kernel.org/pub/software/scm/git/docs/git-send-email.html

* If your mail client supports setting the In-Reply-To header
  via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line before the message body.
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox