Re: Feedback on Linux Manual Website - Translation Feature Compatibility

[Alejandro Colomar <alx@kernel.org>]

[-- Attachment #1: Type: text/plain, Size: 2022 bytes --]

Hi zmy,

On Wed, May 01, 2024 at 12:18:35PM +0800, 凄临雨 wrote:
> Feedback on Linux Manual Website - Translation Feature Compatibility
> 
> Dear Linux Manual Web Team,
> 
> I hope you are doing well.  I am reaching out to provide some feedback
> regarding the Linux Manual website that I believe could help improve
> its usability for a wider audience.

Can you please provide a link to the website you're referring to?

> I have noticed that the <pre&gt; tags used on the website to display
> code and command examples are not compatible with the translation
> features embedded in web browsers.

The current website is <https://www.kernel.org/doc/man-pages/>, but that
is minimal and doesn't have any <pre> tags.

Or maybe you're referring to
<https://git.kernel.org/pub/scm/docs/man-pages/man-pages.git/tree/README>
?

That's not the website, but rather a web view of the source code of the
repository.  It does use <pre> for everything, but because it's
formatting an entire file in the source repository.

Have a lovely day!
Alex

> This has created a barrier for
> non-native English speakers who rely on these translation tools to
> better understand the technical content presented.
> 
> The use of <pre&gt; tags to preserve the formatting of code blocks
> unfortunately prevents these users from being able to translate the
> text easily.  While the intention to maintain the original formatting
> is appreciated, it would be beneficial to explore alternatives that
> allow the translation functionality to work alongside the display of
> code.
> 
> I wanted to bring this to your attention as it impacts the
> accessibility of the content for international users.  I believe
> addressing this could significantly enhance the user experience for a
> diverse audience.
> 
> Thank you for the excellent resources you provide to the Linux
> community, and for considering this feedback.
> 
> Warm regards,
> 
> zmy

-- 
<https://www.alejandro-colomar.es/>

[-- Attachment #2: signature.asc --]
[-- Type: application/pgp-signature, Size: 833 bytes --]