diff --git a/documentation/feature/advanced_ballistics.md b/documentation/feature/advanced_ballistics.md
index 575ded2976..671164a2d9 100644
--- a/documentation/feature/advanced_ballistics.md
+++ b/documentation/feature/advanced_ballistics.md
@@ -6,15 +6,15 @@ parent: wiki
---
# Overview
## Advanced ballistics simulation
-Advanced ballistics changes above and beyond the ballistics module. Bullet velocity and flight paths are dynamically simulated in response to the following factors:
+The advanced ballistics module improves projectile physics by simulating internal and external ballistics. Factors used in the simulation include:
- Ambient air pressure, temperature and humidity
- Wind drift
- [Magnus effect](https://en.wikipedia.org/wiki/Magnus_effect) (spin drift)
- [Coriolis effect](https://en.wikipedia.org/wiki/Coriolis_effect) and [Eötvös effect](https://en.wikipedia.org/wiki/Eotvos_effect) (Earth rotation)
- Loss of stability during transonic flight
-- Ammo temperature
-- Barrel length
+- Variable muzzle velocity based on on powder burn rate and barrel length
+- Barrel length effect on muzzle velocity
## Advanced drag model
Realistic drag modeling based on the G Model and real-world ballistic coefficient data.
@@ -22,11 +22,14 @@ Realistic drag modeling based on the G Model and real-world ballistic coefficien
## Wind simulation
Wind speed varies with altitude. Terrain features, buildings and other objects disrupt the wind.
+## Bullet trace effects
+Supersonic bullets have a refraction effect due to air pressure waves.
+
## Protractor
-Adds a protractor for quick reference when sniping.
+Adds a protractor for quickly measuring inclination angle.
# Usage
-Press Ctrl+Shift+K to display the protractor.
+Press Ctrl+Shift+K while using a compatible weapon to toggle the protractor. The red line indicates the current inclination angle in degrees. The protractor will disappear if you lower or holster your weapon.
This module uses relatively complex scripting. Several options are provided in the ACE menu to reduce the performance impact of this module.
diff --git a/documentation/feature/ballistics.md b/documentation/feature/ballistics.md
index 08366ed49c..5d2f92baa9 100644
--- a/documentation/feature/ballistics.md
+++ b/documentation/feature/ballistics.md
@@ -12,20 +12,23 @@ Changes include adjusted muzzle velocity, air friction and dispersion based on r
## Weaker body armor
Decreases protection values of vests, CSAT uniforms and various campaign only gear to levels comparable to Arma 2.
-## Realistic silencers and sub-sonic ammunition
-Silencers no longer decrease the muzzle velocity and are generally less effective when used with normal ammunition. They now only remove the muzzle blast and flash. To prevent the crack caused by super sonic projectiles, AGM introduces sub sonic ammunition. This is also fully compatible with AI. Sub sonic ammunition is available for the calibers 5.56mm, 6.5mm and 7.62mm.
+## Realistic silencers and subsonic ammunition
+Silencers no longer decrease the muzzle velocity and are generally less effective when used with normal ammunition. They now only remove the muzzle blast and flash. To prevent the crack caused by supersonic projectiles, ACE introduces subsonic ammunition for the 7.62mm caliber. This is also fully compatible with AI.
## Armour piercing ammunition
-Armour piercing rounds have higher penetration values against light armoured targets or other obstacles on the battlefield. Their drawback is a slightly decreased man-stopping power. AP rounds are available for the calibers 5.56mm, 6.5mm and 7.62mm.
+Armour piercing rounds have higher penetration values against light armoured targets or other obstacles on the battlefield. Their drawback is a slightly decreased man-stopping power. AP rounds are available multiple calibers incudling 5.56mm and 7.62mm.
## IR-Dim tracer ammunition
IR-Dim ammunition is similar to tracer rounds, but their tracers are only visible using night vision devices.
-## M118 Long range ammunition
-The M14 EBR now uses ammunition with decreased muzzle velocity and air friction to improve precision on long ranges.
+## M118 long range ammunition
+The M14 EBR now uses ammunition with decreased muzzle velocity and air friction to improve precision and energy retention at long ranges.
## Flash suppressors
Flash suppressors are similar to sound suppressors and prevent the muzzle flash reducing visibility without decreasing combat effectiveness. Flash suppressors are available for the calibers 5.56mm, 6.5mm, 7.62mm, .45 ACP and 9mm.
+## Fully config-based
+This module uses configuration changes only and does not decrease game performance.
+
# Dependencies
`ace_common`