Re: Handbook: improving Chapter 6 Wayland

Hi Alice,
 
>Четверг, 25 сентября 2025, 01:17 +03:00 от Alice <alice.arcanorum@gmail.com>:
> 
>Hello everyone
>
>I am a new FreeBSD user, and I've been following the handbook.
>The quality of the documentation is really good, and it's really easy to
>follow.
>
>When I got to chapter 6 (Wayland) I had some troubles initially.
>Some of the problems were a bit difficult to troubleshoot, and I had to dig
>in the forums to find the fixes (which was tiring, but also fun).
>
>For this reason, I decided that I want to give back to the community and
>improve the chapter, adding hints to avoid the same pitfalls I fell into :)
>In the following days, I will try to redo everything in a virtual machine
>to make sure I don't miss anything that can be useful.
>
>I found in the archives an e-mail instructing on how to contribute, so I read
>the FDP and created a fork in Github, and I will be sending a PR when I'm
>done.
The Documentation Project usually discuss all changes in Phabricator — FreeBSD
review system —  https://reviews.freebsd.org  . It is explained in
https://wiki.freebsd.org/Phabricator  . You do not need to make all those installations.
When patch is ready, save it to file:
git format-patch -U999999 --stdout main > change.diff
create new Differencial, attach the patch, assign repository Doc,
write description — done, write email in freebsd-doc to get attention.
 
>Initially I thought about listing in this e-mail the various changes that I
>intend to make, but the e-mail was becoming really long and I'm not sure if
>that would have been useful.
>In case, let me know and I will share my ideas.
>
>The sections I expect to modify are:
>6.2 Wayland Overview
>6.3 The Wayfire Compositor
 
Best regards.
Vladlen Popolitov