diff --git a/docs/refguide.xml b/docs/refguide.xml
index 039eea079..0db3e623c 100644
--- a/docs/refguide.xml
+++ b/docs/refguide.xml
@@ -4645,25 +4645,29 @@ Service scan Timing: About 33.33% done; ETC: 20:57 (0:00:12 remaining)
version available from . If the problem persists,
do some research to determine whether it has already been
- discovered and addressed. Try searching for the error message on our search page at or at Google. Also try
- browsing the nmap-dev archives at .nmap-dev mailing list
- Read this full manual page as
- well. If nothing comes of this, mail a bug report to
- dev@nmap.org. Please include everything
- you have learned about the problem, as well as what version of
- Nmap you are running and what operating system version it is
- running on. Problem reports and Nmap usage questions sent to
- dev@nmap.org are far more likely to be answered than
- those sent to Fyodor directly. If you subscribe to the nmap-dev
+ discovered and addressed. Try searching for the problem or error message on
+ Google since that aggregates so many forums. If nothing comes of this, create an Issue on our tracker
+ () and/or mail a bug report to
+ dev@nmap.org. If you subscribe to the nmap-dev
list before posting, your message will bypass moderation and get
- through more quickly. Subscribe at .
+ through more quickly. Subscribe at . Please include everything
+ you have learned about the problem, as well as what version of
+ Nmap you are using and what operating system version it is
+ running on. Other suggestions for improving Nmap may be sent to
+ the Nmap dev mailing list as well.
+
+ If you are able to write a patch improving Nmap or fixing a
+ bug, that is even better! Instructions for submitting patches or
+ git pull requests are available from
+
+ Particularly sensitive issues such as a security reports may
+ be sent directly to Nmap's author Fyodor directly at
+ fyodor@nmap.org. All other reports and comments
+ should use the dev list or issue tracker instead because more
+ people read, follow, and respond to those.
- Code patches to fix bugs are even better than bug reports.
- Basic instructions for creating patch files with your changes are
- available at . Patches may
- be sent to nmap-dev (recommended) or to Fyodor directly.