From 6bb8e9c25400338b28f7cec02a6cab3928df75e6 Mon Sep 17 00:00:00 2001 From: RubbaBoy Date: Sat, 21 Dec 2019 21:36:48 -0500 Subject: [PATCH 1/2] Replaced README and CONTRIBUTING files The previous README and CONTRIBUTING were both text, the readme being non-intriguing with nothing to really hook a user looking at the project. This doesn't need to be accepted, however I'd recommend using it as a reference or similar for a future rework of the readme. HTML can also be used if you don't want to use Markdown. --- CONTRIBUTING.md | 13 +++++++++++++ CONTRIBUTING.txt | 20 -------------------- README.md | 42 ++++++++++++++++++++++++++++++++++++++++++ README.txt | 45 --------------------------------------------- 4 files changed, 55 insertions(+), 65 deletions(-) create mode 100644 CONTRIBUTING.md delete mode 100644 CONTRIBUTING.txt create mode 100644 README.md delete mode 100644 README.txt diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md new file mode 100644 index 0000000..e15244c --- /dev/null +++ b/CONTRIBUTING.md @@ -0,0 +1,13 @@ +# Contributing Guidelines + +Contributing entails that all contributions follow the [MPL 2.0 license](https://github.com/buffet/kiwmi/blob/master/LICENSE). + +## Opening Issues + +- Ensure that bugs have proper steps to reproduce +- Include program version, along with any system specs that may help identify the issue + +## Committing + +Commit messages should be both _clear_ and _descriptive_. If possible, commit titles should start with a verb describing the change. Don't be shy to include additional information such as motivation for the change in the commit body. Be sure to ensure other developers will be able to understand _why_ a specific change has occurred in the future. + diff --git a/CONTRIBUTING.txt b/CONTRIBUTING.txt deleted file mode 100644 index 37cc2d9..0000000 --- a/CONTRIBUTING.txt +++ /dev/null @@ -1,20 +0,0 @@ -Contribution Guidelines -======================= - -NOTE: contributing implies that your contributions get licensed under the terms of MPL 2.0. - -Opening Issues --------------- - -- Make sure you have a GitHub account. -- Include steps to reproduce, if it is a bug. -- Include information on what version you are using. - -Submit Changes --------------- - -Commit messages should be both clear and descriptive. -If possible they should start with the verb that describes the change. -Don't be shy to include additional information, like motivation, for that change below the initial line. - -Other developers should be able to understand why a change occurred, when looking at it at a later point in time. diff --git a/README.md b/README.md new file mode 100644 index 0000000..0a5a5d6 --- /dev/null +++ b/README.md @@ -0,0 +1,42 @@ +

kiwmi

+

A fully programmable Wayland Compositor.

+

+ HitCount + Stars + GitHub issues + GitHub contributors +

+ +kiwmi is a work-in-progress extensive user-configurable Wayland Compositor. kiwmi specifically does not enforce any logic, allowing for the creation of Lua-scripted behaviors, allowing for arduous tasks such as modal window management become a breeze. New users should be aware of the steep learning curve present, however this will be reduced as the project matures. + + +## Getting Started + +The dependencies required are: + +- [wlroots](https://github.com/swaywm/wlroots) +- meson (building) +- ninja (building) +- git (source control) + +### Building + +After cloning/downloading the project and ensuring all dependencies are installed, building is as easy as running + +``` +$ meson build +$ ninja -C build +``` + +Installing is accomplished with the following command: + +``` +$ ninja -C build install +``` + + +## Contributing + +Contributions are welcomed, especially while the project is in a heavy WIP stage. If you believe you have a valid concern, read the [CONTRIBUTING](https://github.com/buffet/kiwmi/blob/master/CONTRIBUTING.md) document and please file an issue on the [issues page](https://github.com/buffet/kiwmi/issues/new). + +For clarifications or suggestions on anything, please don't hesitate to contact me. \ No newline at end of file diff --git a/README.txt b/README.txt deleted file mode 100644 index fae6599..0000000 --- a/README.txt +++ /dev/null @@ -1,45 +0,0 @@ -kiwmi -===== - -kiwmi is a Wayland compositor that is programmed by the user. -This means that the sky is the limit: -You can implement any tiling or floating logic you want; even stuff like modal window management becomes easy. - -This means there is a steep entrance barrier, but in the future there will be base configurations to start with. - -NOTE: This whole project is a work in project, and not usable yet. - -Installation ------------- - -Make sure all dependencies are installed. - -Run: - - $ meson build - $ ninja -C build - -Install with: - - # ninja -C build install - -Dependencies ------------- - -- wlroots (https://github.com/swaywm/wlroots) -- meson (build) -- ninja (build) -- git (build, optional, to fetch the version) - -Contribution ------------- - -You want to contribute? Great! - -Future requests, bug reports and PRs are always welcome. -Note that pull requests without a valid issue are ignored to decrease the amount of duplicate work. -Also read CONTRIBUTING.txt. - -If anything is unclear, feel free to contact me. - -If you don't program but want to contribute to kiwmi, spread the word about kiwmi and star the repo. From 2b7bc885d21355f7afd8729a49b8f04dd8ecdc75 Mon Sep 17 00:00:00 2001 From: Charlotte Meyer Date: Sun, 22 Dec 2019 16:50:08 +0000 Subject: [PATCH 2/2] Overhaul readme --- README.md | 16 +++++++++------- 1 file changed, 9 insertions(+), 7 deletions(-) diff --git a/README.md b/README.md index 0a5a5d6..d1008a2 100644 --- a/README.md +++ b/README.md @@ -1,13 +1,14 @@

kiwmi

-

A fully programmable Wayland Compositor.

+

A fully programmable Wayland Compositor

- HitCount Stars GitHub issues GitHub contributors

-kiwmi is a work-in-progress extensive user-configurable Wayland Compositor. kiwmi specifically does not enforce any logic, allowing for the creation of Lua-scripted behaviors, allowing for arduous tasks such as modal window management become a breeze. New users should be aware of the steep learning curve present, however this will be reduced as the project matures. +kiwmi is a work-in-progress extensive user-configurable Wayland Compositor. +kiwmi specifically does not enforce any logic, allowing for the creation of Lua-scripted behaviors, making arduous tasks such as modal window management become a breeze. +New users should be aware of the steep learning curve present, however this will be reduced as the project matures. ## Getting Started @@ -17,7 +18,7 @@ The dependencies required are: - [wlroots](https://github.com/swaywm/wlroots) - meson (building) - ninja (building) -- git (source control) +- git (build, optional) ### Building @@ -31,12 +32,13 @@ $ ninja -C build Installing is accomplished with the following command: ``` -$ ninja -C build install +# ninja -C build install ``` ## Contributing -Contributions are welcomed, especially while the project is in a heavy WIP stage. If you believe you have a valid concern, read the [CONTRIBUTING](https://github.com/buffet/kiwmi/blob/master/CONTRIBUTING.md) document and please file an issue on the [issues page](https://github.com/buffet/kiwmi/issues/new). +Contributions are welcomed, especially while the project is in a heavy WIP stage. +If you believe you have a valid concern, read the [CONTRIBUTING](https://github.com/buffet/kiwmi/blob/master/CONTRIBUTING.md) document and please file an issue on the [issues page](https://github.com/buffet/kiwmi/issues/new). -For clarifications or suggestions on anything, please don't hesitate to contact me. \ No newline at end of file +For clarifications or suggestions on anything, please don't hesitate to contact me.