Skip to content
This repository was archived by the owner on Aug 22, 2025. It is now read-only.
This repository was archived by the owner on Aug 22, 2025. It is now read-only.

Document relevance improvement philosophy #100

@jayaddison

Description

@jayaddison

Is your feature request related to a problem? Please describe.
The sorting and ranking features of RecipeRadar aren't perfect at the moment; they aim to provide the best results based on our experience and engineering ability so far.

Longer-term, we hope and expect to improve these, but we'll need help to do so. Opening ourselves up to that kind of help runs the risk that even the best-intentioned contributors could lead the software and algorithms down paths that are tricky to undo should they be considered problematic in future.

Ideally we'd like to have an approach where it's always possible to tune and adjust the sorting and relevance of results over time, and that it's as easy as possible to provide data-backed evidence, gather community feedback, and then prepare and review changes in a straightforward format.

Currently the best we have for this is the application code and the associated OpenSearch queries that it generates at runtime. Is this good enough? Can we do better?

Describe the solution you'd like
We should document our philosophy around content relevance and try to define guidance and interfaces to make this easy to assess, discuss, review and adjust over time.

Even if we don't realize a perfect implementation of these processes, having a documented philosophy regarding it should help to explain how the system is intended to work, and guide towards via continuous incremental improvement.

Metadata

Metadata

Assignees

No one assigned

    Labels

    documentationImprovements or additions to documentationenhancementNew feature or request

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions