From ba66105be8c0a71b8621f0bb9ab7931b41e710de Mon Sep 17 00:00:00 2001 From: Azat Bahawi Date: Wed, 12 Aug 2020 14:41:24 +0300 Subject: Update README.rst --- README.rst | 30 +++++++++++++++++++++++------- 1 file changed, 23 insertions(+), 7 deletions(-) diff --git a/README.rst b/README.rst index 0069599..eeb2845 100644 --- a/README.rst +++ b/README.rst @@ -10,8 +10,8 @@ Some of them do exist but, for example, live ebuilds are not present or broken. This overlay is aimed to fix these issues and promote Gentoo as a favorable distribution for those who want to customize their desktop. -Installation -############ +Installing and Using +#################### :: @@ -29,12 +29,16 @@ needed to be added or updated. However, you are not limited to only working with it. You are encouraged to add interesting packages related to ricing, customization and workflow improvement. -Some packages here I no longer use or maybe even too lazy to bump to upstream. -Please report any issues rearding that. +Some packages here I no longer use or maybe even too lazy to bump to upstream +versions. Please report any issues rearding that. Making PRs ********** +Make sure you are familiar with how to write and how to format ebuilds and +ebuild repositories. The Gentoo's official and up-to-date guide can be found +`here `_. + Example workflow could look like this (commented out are actions that you perform outside of your terminal): @@ -61,12 +65,24 @@ three words if you think that changes are self-explanatory), for example: changelog, upstream notes and etc. related to the packae in the subsection of the commit message. -It would be really nice if you could also use ``app-portage/repoman`` for QA. +It would be really nice if you could also use ``app-portage/repoman`` and +``app-portage/overlint`` for QA. If you are submiting a new package, include yourself as a maintainer in the -``metadata.xml`` file. +``metadata.xml`` file, for example: + +:: + + + + + + YOUR@EMAIL.HERE + YOUR NAME + + And finally, consider using indentation guides from ``.editorconfig`` file so that the code in the overlay stays uniform. Basically, both ``.ebuild`` and ``.xml`` files are using 4 non-expanded spaces as a tab. You are free to do what -you consider the best in ``${FILESDIR}``. +you consider the best in the ``${FILESDIR}`` with patches and etc. -- cgit 1.4.1