Based on user reports, SNMP documentation welcomes some improvements:

A. SNMP traps:

1. MISTAKE: <q>/tmp/my_zabbix_traps.tmp</q>
COMMENT: In the Script zabbix_trap_handler.sh the logfile is set to "/var/lib/zabbix/snmptraps/snmptraps.log". As both configs need to have the same logfile, this should also be "/var/lib/zabbix/snmptraps/snmptraps.log"

2. MISTAKE: <q>snmptrap["linkup"]</q>
COMMENT: Because of the quotes, the regex doesn't match. Also the "U" needs to be upper case. It should be: snmptrap[linkUp]

3. MISTAKE: <q>Create an SNMP item TEST:
Host SNMP interface IP: 127.0.0.1
Key: snmptrap["linkup"]
Log time format: yyyyMMdd.hhmmss</q>
COMMENT: This could be more detailed:
SNMP Interface needs to be configured in the host config
The IP needs to be the IP of the source host (port doesn't really matter in this case)
item creation is hard to find for new users (hint would be nice)

4. MISTAKE: <q>Create an SNMP item TEST:
Host SNMP interface IP: 127.0.0.1
Key: snmptrap["linkup"]
Log time format: yyyyMMdd.hhmmss</q>
COMMENT: This could be more detailed:
type needs to be "SNMP trap"
Type of information needs to be "Log"
 
B. SNMP agent:
 
1. MISTAKE: *q*This item uses GetBulk requests with SNMPv2 and v3 interfaces and GetNext for SNMPv1 interfaces* max repetitions for bulk requests are configured on the interface level./q*This item uses GetBulk requests with SNMPv2 and v3 interfaces and GetNext for SNMPv1 interfaces max repetitions for bulk requests are configured on the interface level.
COMMENT: How does max repetitions afects the blk requests? it will insist X time till it gets the data? will break the oid in groups of max repetitions OIDs ....
 
C. Configuring a host:
 
1. MISTAKE: <q>Interfaces</q>
COMMENT: Missing SNMPv3 information