Examples in lessons should use roles, not invented names. A role allows any person in that role to understand the example directly. This makes the lesson useful to more people.
By Pawan Nayar · from the LLOS AI Learning record
Examples in lessons should use roles, not invented names.
A role allows any person in that role to understand the example directly. This makes the lesson useful to more people.
An example with a name, like Maria, feels specific to one person. A reader from a different place or culture might find it hard to relate. The reader must imagine themselves as that specific person. An example with a role, like 'a developer,' has no specific owner. Anyone who is a developer can see themselves in the example. The lesson becomes clear and useful to many people. Using roles makes the situation the main point, not the person. The situation can be understood by everyone. A specific name is not universal.
A developer reads a lesson that says, 'Maria found a bug in her code.' The developer might think about Maria, not the bug. If the lesson says, 'A developer found a bug in the code,' any developer can easily relate to finding a bug.
Resolved from this lesson's own record — real definitions, not invented for this page.
More from the same record, pulled by shared topic — not written new for this page.
A new way of writing or a new concept must be shown in an example. The example acts like a teacher.
A lesson uses simple words. A lesson uses short sentences.
A lesson makes the reader feel invited. The reader should feel ready to learn.
The AI model can use specific examples of loss. These examples show how a person's role changes.
Examples in lessons should use roles, not invented names. A role allows any person in that role to understand the example directly. This makes the lesson useful to more people.