From d6c73987f5f56e9b43d93bb7e020f16e933a67c2 Mon Sep 17 00:00:00 2001 From: Llewellyn van der Merwe Date: Mon, 27 Feb 2023 14:33:19 +0200 Subject: [PATCH] Updated the Support and Contribution info. --- .github/CONTRIBUTING.md | 21 +++++++-------------- .github/SUPPORT.md | 39 +++++++++++++++++---------------------- 2 files changed, 24 insertions(+), 36 deletions(-) diff --git a/.github/CONTRIBUTING.md b/.github/CONTRIBUTING.md index 7ae4e2d56..8c7ce1943 100644 --- a/.github/CONTRIBUTING.md +++ b/.github/CONTRIBUTING.md @@ -1,24 +1,17 @@ Contributing to the Joomla Component Builder (JCB) =============== -You are welcome to submit a contribution for review and possible inclusion in the Joomla Component Builder but, before it will be accepted, we ask that you follow these simple steps: +If you wish to submit a contribution for review and potential inclusion in the Joomla Component Builder (JCB), please follow these simple steps: -1) Please watch [these tutorials][Tutorials] +1) Open an issue on GitHub, and if possible, provide a fix and create a pull request (PR). Creating a PR automatically generates an issue so that you do not need to create one separately. -2) Open an issue on GitHub. If you can, please provide a fix and create a pull request (PR) instead; this will automatically create an issue for you so you do not have to create an issue if you are creating a pull request. +2) Adhere to the [Joomla! Coding Standards](https://developer.joomla.org/coding-standards.html). -3) Follow the [Joomla! Coding Standards][Standards]. +3) When filing an issue or opening a PR, provide a clear and concise title and description. The title should include a brief summary of the issue and reference to an open issue if possible. For example, Invalid Query in com_admin (Ref #1234) is sufficient. Additionally, provide a detailed description of the issue or PR, including what the problem is, what the PR is addressing, testing instructions, and environmental information such as PHP version and database driver and version, in case the issue is specific to certain environments. -4) When filing an issue or opening a PR, please include a clear title and description. The title should be a short summary of an issue and, if possible, should include a reference to an open issue. For example, `Invalid Query in com_admin (Ref #1234)` would be sufficient. All issues and PRs should include a description with as much detail as possible. -If it is a PR, include what the issue is, what the PR is addressing, testing instructions and environmental information (PHP version, database driver and version, and other data you can retrieve from your site's system information view) in case the issue is specific to certain environments. If additional information is needed, please be prepared to provide it as our community members review your submission. +4) Report security issues to the JCB! Core Team using the [Report security issues contact form](https://www.vdm.io/report-security-issues) instead of using public forums. -5) Report security issues to the JCB! Core Team using the [Report security issues contact form][Security]. Please do not use the public forums for security issues. - -Please be patient as not all items will be tested immediately (remember, all bug testing for the JCB is done by volunteers) and be receptive to feedback about your code. +Please be patient, as not all items will be immediately tested since all bug testing for the JCB is performed by volunteers. Additionally, be open to feedback regarding your code. #### Branches -PRs should usually be made to the `staging` branch as this contains the most recent version of the code. - -[Tutorials]: https://www.youtube.com/watch?v=lLOfx9YA7VQ&list=PLQRGFI8XZ_wsfz3NdKawCiYsALuZ-GhwJ -[Standards]: https://developer.joomla.org/coding-standards.html\ -[Security]: http://joomlacomponentbuilder.com/report-security-issues +For PRs, submit to the staging branch as it contains the most up-to-date version of the code. diff --git a/.github/SUPPORT.md b/.github/SUPPORT.md index 905f46fc1..1d8b13a8f 100644 --- a/.github/SUPPORT.md +++ b/.github/SUPPORT.md @@ -1,27 +1,22 @@ Where can you get support and help? ==================== -+ [The JCB Tutorials][Tutorials] -+ [Hello World Tutorial][HelloWorld] -+ [The JCB! Wiki][Wiki] -+ [JCB Forum][forum] -+ [Report a Security Issue][Security] -+ [Community Complaint][Complaint] -+ [Open Issue On Github][Issue] ^^ +- [Package](https://git.vdm.dev/joomla/pkg-component-builder). +- [Download](https://git.vdm.dev/joomla/pkg-component-builder/archive/master.zip). +- [Tutorials](https://www.youtube.com/playlist?list=PLQRGFI8XZ_wtGvPQZWBfDzzlERLQgpMRE). +- [German](https://www.youtube.com/playlist?list=PLQRGFI8XZ_wu0tDFxJtZFwW7AxA4JHQV7). +- [Hello World](https://www.youtube.com/watch?v=IQfsLYIeblk&list=PLQRGFI8XZ_wtGvPQZWBfDzzlERLQgpMRE&index=45). +- [Discussions](https://github.com/vdm-io/Joomla-Component-Builder/discussions). +- [Wiki](https://git.vdm.dev/joomla/Component-Builder/wiki). +- [Issues](https://git.vdm.dev/joomla/Component-Builder/issues). ^^ +- [Issues Stream](https://t.me/jcb_issues). +- [Updates](https://t.me/jcb_updates). +- [User Group](https://t.me/jcb_group). +- [Announcement](https://t.me/Joomla_component_builder). +- [Beta](https://git.vdm.dev/joomla-beta/pkg-component-builder). +- [Nightly Build](https://git.vdm.dev/joomla-beta/pkg-component-builder/archive/master.zip). +- [Community Complaint](https://www.joomlacomponentbuilder.com/community-complaint). +- [Security](https://www.vdm.io/report-security-issues). -Since JCB has become a community project [VDM.io][VDM] is **no longer solely responsible** for support. - -We have started a [**JCB forum**][forum] where you can post questions, about how things work, or if you need some kind of help in relation to your development of your components. - -^^ Then if you run into any issues, related to the JCB code, like bugs, **start by searching** the (*open & closed*) [issues][Issue] over on Github, and if the issue has not been mentioned before, **then only** open a new issue, following the [community guidelines][guidelines]. - -[Tutorials]: https://www.youtube.com/playlist?list=PLQRGFI8XZ_wtGvPQZWBfDzzlERLQgpMRE -[HelloWorld]: https://www.youtube.com/watch?v=IQfsLYIeblk&list=PLQRGFI8XZ_wtGvPQZWBfDzzlERLQgpMRE&index=45 -[Wiki]: https://git.vdm.dev/joomla/Component-Builder/wiki -[forum]: https://vdm.bz/jcb-forum -[Security]: http://joomlacomponentbuilder.com/report-security-issues -[Complaint]: http://joomlacomponentbuilder.com/community-complaint -[Issue]: https://git.vdm.dev/joomla/Component-Builder/issues -[VDM]: https://www.vdm.io/joomla-component-builder -[guidelines]: https://git.vdm.dev/joomla/Component-Builder/src/branch/master/.github/CONTRIBUTING.md +^^ Then if you run into any issues, related to the [JCB](https://git.vdm.dev/joomla/Component-Builder/issues) code, like bugs, **start by searching** the (*open & closed*) issues over on [Gitea](https://git.vdm.dev/joomla/Component-Builder/issues), and if the issue has not been mentioned before, **then only** open a new issue, following the [community guidelines](https://git.vdm.dev/joomla/Component-Builder/src/branch/master/.github/CONTRIBUTING.md).