microsoft / microsoft/powerquery-parser

field-specification Deviation Double-Check

Open
#354 0 comments 0 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

Dominant language
TypeScript
Stars
137
Forks
34
Avg merge
50m
Merged PRs (30d)
1

Description

Hello,

In https://github.com/microsoft/powerquery-parser/blob/master/specification.md, the following deviation from the M language spec is mentioned:

  • The field-specification construct requires an identifier. Instead identifer is replaced with generalized-identifier.

The spec currently contains the following grammar definitions:

field-specification:
      optional(opt) field-name field-type-specification(opt)

field-name:
      generalized-identifier
      quoted-identifier

With the way field-name currently is defined, is the above-quoted bullet a legacy relic that can be removed?

Ben

Contributor guide

No contributing guide indexed for this repository

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

Research direction

Start with specification.md and compare the quoted field-specification and field-name grammar with the referenced M language specification. Confirm whether generalized-identifier is already fully covered by field-name, then remove or retain the deviation note accordingly. Done means the specification accurately describes the language without a redundant legacy exception.

Written by the indexing model from the issue text.

Assessment

Domain
compilers, documentation
Issue type
Documentation
Difficulty
2/5
Estimated time
1-3 hours
Activity status
Stale
Clarity
Mostly clear
Newbie friendliness
45/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.