A decor is essentially metadata attached to an entity which can then be read from scripts. So if you want to remember that ped X has been investigated by you, you could give it a decor to save that data. They are available in multiple flavors such as integer, boolean and float. If you look at game scripts and look for the string I gave you, you should be able to find references to decors.