added a warning for installing sway

[Ghodawalaaman]

No description provided.

[dbaio]

Hi.

I don't think it's best to put the warning at the start of the section. Maybe it would fit better later on, where it seems more natural.

Also, there is already a link at the beginning of this chapter to 'How to Identify and Configure Drivers for Your Graphics Hardware' that might be useful.

[Ghodawalaaman]

I didn't know about that chapter in the book, however it still makes sense to at least warn user before they install Sway and try to run it.

maybe we should point the user to that chapter saying "please read this section before installing sway"

[sergio-carlavilla]

I didn't know about that chapter in the book, however it still makes sense to at least warn user before they install Sway and try to run it.

maybe we should point the user to that chapter saying "please read this section before installing sway"

Can you please change your patch to make this change?
I think it's a good idea :)

[Ghodawalaaman]

I have changed the commit and now it points the user to section 'How to Identify and Configure Drivers for Your Graphics Hardware'.

I hope it will be useful for someone.

[dbaio]

I suggest something like this to avoid a warning or note at the start of the section.

`diff --git a/documentation/content/en/books/handbook/wayland/_index.adoc b/documentation/content/en/books/handbook/wayland/_index.adoc
index f82f0459d6..d6b5168e9f 100644
--- a/documentation/content/en/books/handbook/wayland/_index.adoc
+++ b/documentation/content/en/books/handbook/wayland/_index.adoc
@@ -372,6 +372,11 @@ To start Hikari, use the following command:

The Sway compositor is a tiling compositor that attempts to replace the i3 windows manager.
It should work with the user's current i3 configuration; however, new features may require some additional setup.
+
+Before starting the Sway installation, ensure that a graphics card (GPU) is installed and configured correctly.
+Refer to the section crossref:x11[x-graphic-card-drivers,drivers for your graphics hardware] for guidance.
+This step is essential for the Sway compositor to function properly.
+
In the forthcoming examples, a fresh installation without migrating any i3 configuration will be assumed.
To install Sway and valuable components, issue the following command as the root user:`

thoughts?

[pauamma]

I'd make that a link, as explained in https://docs.freebsd.org/en/books/fdp-primer/asciidoctor-primer/#_links_to_the_same_file_or_to_another_file_in_the_same_book .

[Ghodawalaaman]

@dbaio I like how you have done it. It feels much more natural than putting it inside Note tag.

can I add the changes given by you into my pull request?

[dbaio]

@dbaio I like how you have done it. It feels much more natural than putting it inside Note tag.

can I add the changes given by you into my pull request?

Yes, please. I can push this PR to the tree tonight or tomorrow

[dbaio]

Thanks, this has been submitted to the tree.