mirror of
https://github.com/joomla-extensions/weblinks.git
synced 2024-11-01 03:12:29 +00:00
42 lines
2.0 KiB
Markdown
42 lines
2.0 KiB
Markdown
# Joomla! Weblinks Contribution Guide
|
|
|
|
Thanks for your interest in this extension for Joomla. Please review the following notes about contributing and maintaining this package.
|
|
|
|
## Version Strategy
|
|
|
|
* When in doubt, refer to the new Joomla development strategy modelled on Semver (link).
|
|
* The major version of this package is synchronised with the major version of Joomla it is designed to run under.
|
|
For example, Weblinks 3.x is designed to run under Joomla 3.x; Weblinks 4.x under Joomla 4.x; and so on.
|
|
* A new minor version will be released each time there is a new feature or a significant change made to the package.
|
|
* A new patch version will be released each time there is a bug or cosmetic fix made to the package.
|
|
|
|
## Pull Requests
|
|
|
|
First fork this repository under your own account and make the changes to the code that you want to make.
|
|
Then make a Pull Request against the `master` branch of this repository.
|
|
|
|
### @since tags
|
|
|
|
If adding new PHP class methods or properties, the `@since` tags should be given the value of `__DEPLOY_VERSION__`.
|
|
This special tag will be replaced when the new version is built.
|
|
|
|
## Bugs and Issues
|
|
|
|
You can browse existing issues [here](https://github.com/joomla-extensions/weblinks/issues).
|
|
|
|
If you find any new bugs, or want to raise any type of support issue, please use raise a
|
|
[new issue](https://github.com/joomla-extensions/weblinks/issues/new).
|
|
|
|
## Release Procedure
|
|
|
|
This is the procedure and checklist for creating a new package:
|
|
|
|
* Update the version number in `jorobo.ini`
|
|
* Modify `jorobo.ini`, add your GitHub token and add ` Release` after `Package`
|
|
* Run `robo build` to make the new package and auto-upload and release it on GitHub.
|
|
* Go to the releases page on GitHub, review the Changelog and change the status from Pre-Release to Stable.
|
|
* Create a new `<update>` tag in the `manifest.xml` file.
|
|
- Change the `<version>` tag to the new version.
|
|
- Change the `<downloadurl>` tag to match the URL of the new release.
|
|
- Commit the change.
|