freddie-freeloader / Typed-Markup-Revisited

Typesafe Markup for well structured Documents
0 stars 0 forks source link

Mention EP early on #10

Open lordxist opened 6 years ago

lordxist commented 6 years ago

Maybe it would be good to mention the Expression Problem already in the introduction. You already hint at it in HSXML advantage (2) "easy extensibility".

Since you talk in 2.1 about extensibility "dimensions", it would be good to also briefly say something about them in the introduction.

You don't need a full definition/explanation (it's fine for that to stay in 2.3), but IMHO it would be nice to at least namedrop the EP and extensibility dimensions early on ("say what you want to say before saying it").

Other than that, I think your other issues already cover all that remains to be done (especially those labeled must fix). As always, don't forget to slowly read the entire thing once more when done, keeping an eye out for typos and grammar.