2021-07-02 06:00:28 +02:00
|
|
|
# Hacking
|
|
|
|
|
2021-08-13 08:02:42 +02:00
|
|
|
Everyone can [hack][] naxalnet. See below for how to hack.
|
2021-07-07 10:38:05 +02:00
|
|
|
|
2021-12-01 16:57:27 +01:00
|
|
|
## Questions and answers
|
2021-10-31 15:48:56 +01:00
|
|
|
|
|
|
|
Join the XMPP channel <xmpp:naxalnet@chat.disroot.org> to talk about
|
|
|
|
anything related to this program or about mesh networks in general.
|
|
|
|
|
2021-07-07 10:38:05 +02:00
|
|
|
## Reporting issues and suggesting ideas
|
2021-07-02 06:00:28 +02:00
|
|
|
|
|
|
|
To report a bug or suggest an idea, create a new issue at
|
2021-09-29 11:44:13 +02:00
|
|
|
<https://git.disroot.org/pranav/naxalnet/issues>
|
2021-07-02 06:00:28 +02:00
|
|
|
|
2021-12-01 16:57:27 +01:00
|
|
|
While reporting a bug, you can add the debug messages to provide more
|
|
|
|
data. Run `journalctl -fu naxalnet` on a terminal emulator (this could
|
|
|
|
take some time on some machines). Now on another one, type `sudo systemctl start naxalnet.service` or whatever caused the error. Now copy the error
|
|
|
|
messages and paste it in the issue body along with the description.
|
2021-10-15 12:35:06 +02:00
|
|
|
|
2021-08-13 08:02:42 +02:00
|
|
|
## Improving documentation
|
2021-08-02 12:35:24 +02:00
|
|
|
|
2021-12-01 16:57:27 +01:00
|
|
|
The README and HACKING.md needs to be more beginner friendly. See #20.
|
2021-08-02 12:35:24 +02:00
|
|
|
|
2021-07-02 06:00:28 +02:00
|
|
|
## Contribute code
|
|
|
|
|
2021-12-01 16:57:27 +01:00
|
|
|
To push to this repo, you need your username to be in the contributors
|
|
|
|
list. Add your username to issue #8 to add you as a contributor. Before
|
|
|
|
each commit, update the CHANGELOG.md and `__version__` in
|
|
|
|
`naxalnet/__init__.py`
|
2021-07-02 06:00:28 +02:00
|
|
|
|
|
|
|
## Packaging
|
|
|
|
|
2021-12-01 16:57:27 +01:00
|
|
|
Currently this program is only packaged for Arch Linux. naxalnet needs
|
|
|
|
packages in GNU+Linux+systemd distributions such as Debian, Fedora,
|
|
|
|
openSUSE, and nixos. If you know/like to package it in your distro, post a
|
|
|
|
message to issue #6.
|
2021-07-07 10:38:05 +02:00
|
|
|
|
|
|
|
[hack]: https://catb.org/jargon/html/H/hack.html
|