Reporting a Bug
Issues are a quick way to point out a bug. If you find a bug or documentation error in NodCMS then please make sure that:
- There is not already an open Issue
- The Issue has not already been fixed (check the develop branch or look for closed Issues)
- It's not something really obvious that you can fix yourself
Reporting Issues is helpful, but an even better approach is to send a Pull Request, which is done by Forking the main repository and making a Commit to your own copy of the project. This will require you to use the version control system called Git.
See SECURITY.md.
Use a descriptive subject line (eg parser library chokes on commas) rather than a vague one (eg. your code broke).
Address a single issue in a report.
Identify the NodCMS version (eg 4.0.1) and the component if you know it (eg. parser library)
Explain what you expected to happen, and what did happen. Include error messages and stacktrace, if any.
Include short code segments if they help to explain. Use a pastebin or dropbox facility to include longer segments of code or screenshots - do not include them in the issue report itself. This means setting a reasonable expiry for those, until the issue is resolved or closed.
If you know how to fix the issue, you can do so in your own fork & branch, and submit a pull request. The issue report information above should be part of that.
If your issue report can describe the steps to reproduce the problem, that is great. If you can include a unit test that reproduces the problem, that is even better, as it gives whoever is fixing it a clearer target!