Closed paulremo closed 2 years ago
@paulremo do I really need to change the capitalization inside terms.md ? That means I have to refactor each reference as well. It takes a very long time for not a big deal, isn't it ?
Changing the capitalization inside terms.md
should be really quick - and for the references in the rest of the document you can just do a (case-sensitive!) search and replace. That should be very quick, no?
I'll do my best
Great!
The terms and definitions in the original handbook were capitalized (e.g., CONTRIBUTING FACTOR). This is problematic when references are generated to terms throughout the book automatically because capitalized terms have ugly plurals (e.g., CONTRIBUTING FACTORs).
The following things should be done:
terms.md
;{term}`contributing factor<Contributing factor>`
(you are free to stick to the standard capitalization rules forcontributing factor
but stick with the capitalization used in the glossary for the text<Contributing factor>
Attention:
{term}
role in titles (neither for abbreviations nor for terms and definitions)- only use it in the standard text@csxADS: Be careful when automatically changing text in multiple documents. For example, failure models on this page was changed to FAILURE MODEls (mode is not a model)!