Re: [LDWG] An online open-source book that may be useful for existing documentation efforts.

On Tue, 7 Jan 2025, ykla wrote:

> Hi,
>
> I am a member of the FreeBSD Chinese Community (CFC), and over the
> past three years, my team and I have collaboratively authored an
> online book about FreeBSD. Although the book is written in Chinese, I
> believe its content aligns closely with the requirements of the LDWG.
> While language might be a barrier, tools like Google Translate or
> ChatGPT can provide a rapid overview of the entire book.
>
> The project's GitHub repository is accessible at
> https://github.com/FreeBSD-Ask/FreeBSD-Ask, and the online browsing
> page can be accessed at https://book.bsdcn.org/.

Thanks for sending this! One can tell that considerable effort has gone
into creating this. This is really great work!

Unfortunately, there is no one size fits all documentation format, so
additions to the available pool of resources is certainly welcome.

I hope we'll be able to focus on documentation specifically in one of the
future LDWG calls. This is certainly a useful resource, even if it
requires translation.

> The impetus for this book was twofold: the protracted review process
> for FreeBSD documentation and the lack of familiarity among
> contributors with AsciiDoc. The book is written entirely in Markdown,
> a choice that was made to minimize redundancy.

You're making some interesting points - I'll add that feedback to the
documentation topics we have collected on our worksheet.

chris