Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Distinguish literal from unknown concept #466

Merged
merged 2 commits into from
May 4, 2023
Merged

Conversation

brucemiller
Copy link
Contributor

This PR is a modest alternative to #459 that primarily distinguishes concepts not currently know by the AT and literals; the latter now being only explicit literals prefixed by _.

Even though an unknown concept is treated the same as an explicit literal, there is an important distinction: an unknown concept is only unknown for a particular AT and a particular version of the concept dictionaries; future updates may add it to a dictionary and then it is known, possibly with special behaviors.
So, while I would generally discourage use of literals, where someone insists on specific speech that doesn't correspond to a sensible concept, I would recommend they use a literal. This seems better than using a concept hoping that it probably never will be added to a dictionary. Of course, if they think it's a concept then a concept it is.

In this PR, I'm making the distinction in the text below the grammar rather than in the grammar itself. This is solely to avoid getting mired in character class details. If we decide to drop NCNAME and be more explicit in the grammar (something along the lines of a concept starting with a letter; a literal starts with an "_"), we probably should have separate Concept and Literal productions.

src/intent.html Outdated Show resolved Hide resolved
</li>
</ul>
</dd>
<dt><dfn data-dfn-for="intent" id="intent_number">number</dfn></dt>
<dd>
A literal <a data-link-for="intent" data-link-type="dfn" href="#intent_number">number</a> such as <code>2.5</code> denotes itself.
An explicit <a data-link-for="intent" data-link-type="dfn" href="#intent_number">number</a> such as <code>2.5</code> denotes itself.
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

ah good catch, unrelated use of "literal" we should make this change in any case, it is independent of any concept/literal rewording

src/intent.html Outdated Show resolved Hide resolved
Copy link
Contributor

@dginev dginev left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I am very fond of the minimal rewording here.

This PR achieves the main remaining clarification which had ongoing discussion in #459 , and is a great substitute to the work there.

@NSoiffer
Copy link
Contributor

NSoiffer commented May 4, 2023

I am merging this so we have a hopefully better document to discuss at the meeting.

@NSoiffer NSoiffer merged commit 0274979 into main May 4, 2023
github-actions bot added a commit that referenced this pull request May 4, 2023
SHA: 0274979
Reason: push, by NSoiffer

Co-authored-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

4 participants