Compare commits

...

16 Commits

Author SHA1 Message Date
aclist
d80383f5d9
Merge a94f8f0e32 into 661329877f 2025-10-30 02:36:46 +00:00
aclist
a94f8f0e32
Merge pull request #236 from GaryBlackbourne/doc/add-contributing
Some checks are pending
Mirror to Codeberg / mirror-to-codeberg (push) Waiting to run
Doc/add contributing
2025-10-30 11:36:43 +09:00
aclist
0da098afb6 chore: mention branch basing conventions 2025-10-30 11:36:10 +09:00
aclist
506c82e86a chore: reword CONTRIBUTING.md
Corrected some typos and reworded passive voice/some sections for
brevity.
2025-10-25 11:51:19 +09:00
aclist
661329877f
Merge pull request #232 from GaryBlackbourne/fix-deadlock-on-ip-api-server
Some checks failed
Mirror to Codeberg / mirror-to-codeberg (push) Has been cancelled
Fix deadlock on ip api server
2025-10-25 11:30:05 +09:00
Gergely Koloszar
dccdffe761 doc: change branch names to currently used ones 2025-10-24 14:04:37 +00:00
Gergely Koloszar
957ad47b4d doc: add troubleshooting help to contribute.md 2025-10-24 14:01:00 +00:00
Gergely Koloszar
16d8f567a4 doc: add code of conduct notice 2025-10-24 14:00:46 +00:00
Gergely Koloszar
c883fc586c doc: add contributing.md 2025-10-24 13:43:26 +00:00
Gergely Koloszar
cc73f23c1c fix: suppress ping stderr output 2025-10-24 12:35:56 +00:00
aclist
cbc131028f
chore: capitalize TODO for syntax highlighting 2025-10-23 08:22:20 +09:00
Gergely Koloszar
239a82876e fix: silence ping while checking remote urls 2025-10-22 17:20:56 +02:00
aclist
6aa1ec4201 fix: early abort if local coords are missing 2025-10-17 19:12:59 +02:00
Gergely Koloszar
d6223e54b0 Fix unintended deletion 2025-10-17 19:12:59 +02:00
Gergely Koloszar
83552f833c Add availability checks for local_latlon function 2025-10-17 19:12:59 +02:00
Gergely Koloszar
f0657be289 Add availability checker for remote services based on ping and timeout 2025-10-17 19:12:59 +02:00

71
CONTRIBUTING.md Normal file
View File

@ -0,0 +1,71 @@
# Introduction
Thank you for your interest in DZGUI!
This guide goes over development conventions and best practices for contributors.
If you are a developer, you can skip to the end.
# Requesting help
If you encounter a problem with DZGUI, you can submit tickets on the GitHub
(issue tracker)[https://github.com/aclist/dzgui-devel/issues] under the
`troubleshooting` tag.
# How can I help the project?
There are several ways to help this project.
1. Report bugs that you find
2. Request features that you would like
3. Contribute features and fixes to the codebase
4. Contribute documentation to the project
Before making any contribution, please read the `CODE_OF_CONDUCT.md` and act
accordingly.
## Submitting a ticket
Navigate to the GitHub (issue tracker)[https://github.com/aclist/dzgui-devel/issues].
From there, follow the onscreen prompts. You will be asked questions such as:
- What version are you using?
- What distribution are you using?
- What is the issue that you found?
- How can we reproduce the issue?
You can also attach screenshots, logs, or other data that can help us.
## Requesting a feature
You can also request features via the same issue tracker. It is good practice to
first search for your idea to see if a similar one has already been posted.
If not, open a ticket where you describe your feature and its possible benefits.
Please note that this is a community project, so it takes time for us to develop
features. Putting in a feature request does not mean that it will be implemented,
but we will do our best to support as many cool ideas as possible.
## Contributing code or documentation
If you would like to take ownership or assist with an issue on the issue tracker, or
contribute a new change, please follow the guidelines below.
Fork this repository and check out the code up to `prerelease/<latest-version>`.
If there is no pending prerelease PR, you can base your changes off of
the `testing` branch. You may later be asked to retarget your PR to the prerelease
branch once a new one is made. This is because out-of-band PRs are consolidated into
the next release before merging.
The following naming conventions apply for PRs:
- fix/<your-fix> - patch/hotfix branches
- feat/<your-feature> - feature branches
- doc/<your-doc-branch> - documentation branches
- infra/<your-infra-branch> - infrastructure branches
Implement your changes and test them locally. If they work you may
open a merge request, and then we review your changes. If everything is OK, it
will be merged to `prerelease/<latest-version>`, then `testing`, and after a live
testing phase, to `stable` as well.
It is recommended to follow
(Conventional Commits)[https://www.conventionalcommits.org/en/v1.0.0/], as this
integrates well with tooling and helps the project review your code.