I couldn’t have said it better than @JustinG. The only think I’d add is another reason why less documentation is required for the UI is because the UI is self documenting. In addition to all the stuff mentioned, there will be a sentence or two under the field explaining the purpose of that field. You need go nowhere else beyond the UI most of the time to not only know what’s valid but also what’s possible.
In an OH context, these features of the UI are the most important when it comes to defining Things, the Semantic Model, and default widgets.
So yes, I recommended it up front and I still recommend it. If you are going to use the Semantic Model, you are better off doing so in the UI than text files. Then you can spend your time working on your home automation rather than syntax errors.
If you are going to use the semantic model, I also recommend against trying to retrofit your existing Items into it. Instead use “add equipment to model” to recreate bunches of Items all in one go automatically situated in the model.