JacquesCarette
Wiki: Combinator Documentation
The Combinator Documentation page seems pretty well-written, but it hasn't been updated in a while so I'm not sure if it's up-to-date. All of the Haddock documentation links except the first one are 404, which deepens my suspicions.
Unfortunately I can't say much more than that with my current understanding of this corner of Drasil. @balacij when you get a minute, could take a look at it and give your thoughts on what should be done? Thanks!
Contributes to #4401
Disclaimer: I'm not the most familiar with the individual combinators.
Skimming through the page...
Some of these things are outdated because @JacquesCarette changed how noun phrases are constructed. The introduction looks a bit confusing, I think it needs rewriting. One fatal issue with the discussion of NamedIdea is that the page doesn't seem to define what that is. That being said, the rest of the document looks okay. It needs a bit of focusing. Some of the implementation details of how NounPhrases are placed into Sentences look like they can be removed.
I think it would be best to merge these notes into Drasil's Haddock documentation rather than keeping it in the wiki. It's just too specific about the code to live in the wiki and will quickly become outdated as we work on the combinators (these ones change fairly fast, often).
I agree that moving this documentation to live inside the code is a good idea, with the Wiki retaining pointers to that.
