Terminology: weight, score, and metrics

[rspamd]

Terminology: weight, score, and metrics

[moisseev]

Is "weight" the same as "score" ?

In my opinion, as we have symbols with dynamic weights(or scores), it would be logical to have distinct terms weight and score: score = weight * multiplier or vice versa. But I am not sure if we can appropriately change properties in configuration files.

---

The metric section was deprecated in v1.7 according to the metrics.conf file. Was just the file deprecated? Or does that mean the metric section itself was deprecated, and replaced with actions and groups?

Both metric section and metrics.conf file were deprecated and replaced with groups, but they are still supported to maintain configuration compatibility.

https://rspamd.com/doc/migration.html#migration-to-rspamd-170

If the term "metric" no longer has a specific meaning, can we remove that term in the docs as well, or at least remove the implication that the term has specific meaning?

I think we should remove it everywhere in the docs, but create a section about legacy terms and configuration options and mention it there.

What does it mean by "recording symbols in a metric"?

"record symbols in a metric or record their weights" in other words: "add new symbols or change scores of existing symbols".

And what is a "non-captive" composite?

I guess this mean a composite symbol which can be removed if other composite rule wants to remove it.

[TonyGravagno]

Good responses, sincere thanks. Looking for confirmations and actionable decisions so I can make some changes. I'll try to keep changes related to these topics small for easier acceptance/rejection.