When placing a passive component such as a cap or resistor on schematic, most people usually place the relevant rating (usually power for resistors, voltage for caps, and current for inductors) next to the symbol in addition to the actual component resistance, capacitance, or inductance value.
However, as the design solidifies and actual physical components are chosen, the rating for the physical part may be different than (and hopefully, exceeding) the design requirement. For example, I may need a 10V cap on a certain line, but there is a cap that is cheaper or perhaps already stocked by my contract manufacturer that is a 16 V cap but otherwise identical. It would make the most sense to spec out the already-stocked part.
In such a case, what value should be shown on the schematic - Vmax = 16V or 10V? On one hand, I feel that schematic should communicate design requirements, and part substitutions should be decided elsewhere. On the other hand, the schematic also serves as a reference for the actual built circuit - so the actual part rating is more useful from that perspective.
An additional complication is that the BOM is usually generated from the schematic, and thus displaying the design requirement but then also spec'ing a higher-rated part (i.e. for stocking reasons as mentioned above) can lead to confusion if someone compares the specified requirements to listed parts.
I've read this question and the answers linked to it and haven't found an answer to the specific question.