Earlier quoted context omitted.
You can just name the variable to explain what the number is, and if you need more info, there should be a "Why?" doc somewhere explaining the context generally, WITHOUT tying itself directly to the current choice (otherwise you'll have to update the "Why?" doc every time you update the number in the code, which is almost certain to go out of sync). No need to interweave documentation and code, in most cases. Sometim…
This would not work based on my experience What actually would happen is the next person comes along and changes the code and doesn’t update the external doc because it’s probably buried among 100 other pages on confluence and they don’t even know it exists If the comment is in the code they will see it and update accordingly
The external doc is an explanation of what the value does, and what happens when that value is updated, not why it's set to a specific value.