From cf54f75113c69a21cca5ec7e346a12e46298b8c0 Mon Sep 17 00:00:00 2001 From: Ivan Molodetskikh Date: Mon, 25 Mar 2024 21:13:36 +0400 Subject: Move wiki into the main repository --- wiki/Design-Principles.md | 11 +++++++++++ 1 file changed, 11 insertions(+) create mode 100644 wiki/Design-Principles.md (limited to 'wiki/Design-Principles.md') diff --git a/wiki/Design-Principles.md b/wiki/Design-Principles.md new file mode 100644 index 00000000..82521080 --- /dev/null +++ b/wiki/Design-Principles.md @@ -0,0 +1,11 @@ +These are some of the general principles for the design of niri's window layout. They can be sidestepped in specific circumstances if there's a good reason. + +1. Opening a new window should not affect the sizes of any existing windows. +2. The focused window should not move around on its own. + - In particular: windows opening, closing and resizing to the left of the focused window should not cause it to visually move. +3. If a window or popup is larger than the screen, it should be aligned on the top left corner. + - The top left area of a window is more likely to contain something important so it should always be visible. +4. Setting window width or height to a fixed pixel size (e.g. `set-column-width 1280` or `default-column-width { fixed 1280; }`) will set the size of the window itself, however setting to a proportional size (e.g. `set-column-width 50%`) will set the size of the tile, including the border added by niri. + - With proportions, the user is looking to tile multiple windows on screen, so they should include borders. + - With fixed sizes, the user wants to test a specific client size or take a specifically sized screenshot, so they should affect the window directly. + - After the size is set, it is always converted to a value that includes the borders, to make the code sane. That is, `set-column-width 1000` followed by changing the niri border width will resize the window accordingly. \ No newline at end of file -- cgit