drafter icon indicating copy to clipboard operation
drafter copied to clipboard

Report not allowed characters in identifiers

Open abtris opened this issue 11 years ago • 4 comments

@zdne opened apiaryio/snowcrash#41

Currently only some characters are allowed in API Blueprint identifiers.

If illegal character is used the whole section is silently ignored.

Following blueprint should at least produce a warning about illegal identifier (character ')

# Group Parcel 
## Parcel's sticker [/parcels/{parcel_id}/stickers.json]

abtris avatar Oct 15 '13 06:10 abtris

@zdne commented

Also related: apiaryio/snowcrash#70

abtris avatar Jan 31 '14 11:01 abtris

@zdne commented

With apiaryio/snowcrash#70 resolved this only mean that unexpected characters in identifiers are [, ], ( and ).

E.g:

Group Parc ] el

abtris avatar Feb 07 '14 15:02 abtris

@pksunkara commented

What is needed to be done for this to be closed?

abtris avatar Sep 24 '14 10:09 abtris

@zdne commented

Currently a group like this is silently ignored (and treated as a description):

## Group ]A
Hello

To fix this issue the parser should warn that while keyword was find the identifier is not valid. Related issues are apiaryio/snowcrash#31 and apiaryio/snowcrash#65 and should be probably solved in one go.

abtris avatar Sep 26 '14 12:09 abtris