https://bugs.freebsd.org/bugzilla/show_bug.cgi?id=284875

ykla <[email protected]> changed:

           What    |Removed                     |Added
----------------------------------------------------------------------------
             Status|New                         |Closed
         Resolution|---                         |Overcome By Events

--- Comment #8 from ykla <[email protected]> ---
This matter has been dragging on for nearly a year, yet there has still been no
progress on this bug. I will marking it as closed. At present, most of the
communities displayed on the homepage have essentially faded away, and our
community users do not use English, so its practical significance may not be
very great.

The overall activity level of the FreeBSD documentation project is not high,
possibly due to a lack of manpower, insufficient communication, or
unfamiliarity with the toolchain. To this day, the FreeBSD.org homepage still
does not adapt well to mobile devices. The code is highly coupled with Ruby and
the theme itself. With some simple modifications, I managed to deploy it on
Windows. I also tried refactoring it using other frameworks, but the progress
so far has been very limited.

I am considering taking inspiration from the documentation framework of the
official Raspberry Pi website to improve it. However, AsciiDoc (adoc) itself
lacks preview tools, and Hugo has similar limitations in this regard. VitePress
or VuePress may be viable options, and I will continue to explore this
direction. In addition, the structural hierarchy of man pages also needs to be
transformed, at least to ensure that web language translations can correctly
parse these pages. The difficulty lies in the fact that this syntax itself is
also very hard to convert.

Our Chinese community has basically resolved the issue of insufficient Chinese
documentation. We now have our own localized foundational documentation
courses, have translated almost all FreeBSD documentation as well as most
commonly used materials, and have organized subtitles, uploaded videos to the
local community, and compiled content from various FreeBSD project conferences.
It can be said that the entry barrier for beginners is already quite low. At
present, the biggest obstacle lies in the mirror site issue.

The real challenge is that young people today seem not to be interested in
FreeBSD, as few people enjoy a system that downloads only tens of kilobytes
when running pkg install. I understand that this is neither a problem of the
FreeBSD project nor of the users themselves. Human energy is ultimately
limited, and the development of the FreeBSD project will also rise and fall
with changes in the socio-economic environment. I hope that one day, the
real-world constraints that limit these issues can be resolved.

-- 
You are receiving this mail because:
You are on the CC list for the bug.

Reply via email to