search

mbakeranalecta / sam

Semantic Authoring Markdown
Other
79 stars 8 forks source link

Declarations have to come before comments - why? #141

Closed mbakeranalecta closed 6 years ago

mbakeranalecta commented 7 years ago

Why do declarations have to come before comments? Can we ease this restriction without setting traps for ourselves?

mbakeranalecta commented 7 years ago

The obvious answer is that at some point in the future we might add some feature whereby declarations could change the interpretation of comments. Is that a sufficiently good reason to disallow comments before declarations? Is the restriction sufficiently onerous to be worth relaxing?

mbakeranalecta commented 6 years ago

Declarations potentially affect the interpretation of the entire document and therefore deserve to be in a prominent place where they will not be overlooked. Therefore this restriction seems worth retaining. Closing.