Under https://robotframework.org/robotframework/latest/RobotFrameworkUserGuide.html#keyword-scopes, the docs state that the following rule is used when determining keyword priority:

1. Created as a user keyword in the same file where it is used. These keywords have the highest priority and they are always used, even if there are other keywords with the same name elsewhere.

Robot Framework does not actually behave likes this when it comes to resource files. Consider the following three files:

Resource1.robot:

*** Keywords ***
A
    Log  Resource1

Resource2.robot:

*** Keywords ***
A
    Log  Resource2

B
    A

TestSuite1.robot:

*** Settings ***
Resource  Resource1.robot
Resource  Resource2.robot

*** Test Cases ***
Test Case 1
    B

Attempting to run TestSuite1.robot will fail with the following message:

FAIL : Multiple keywords with name 'A' found. Give the full name of the keyword you want to use:
    Resource1.A
    Resource2.A

So keyword B uses keyword A, which is "[c]reated as a user keyword in the same file where it is used". According to the documentation, this should just work. Yet it doesn't.

Considering the way namespacing is actually implemented, I'd suggest updating this line of documentation by adding "test case":

1. Created as a user keyword in the same test case file where it is used. These keywords have the highest priority and they are always used, even if there are other keywords with the same name elsewhere.

You may also want to add something like:

Note
When a test case file defines a keyword, all uses of keywords with the same name in resource files will be overridden, unless they use the full name of the keyword as explained in the next section.

Also, I'd like to use this opportunity to thank you for creating such an awesome piece of software, maintaining and improving it through the years and letting us use it for free. Much, much, much appreciated 🙂!