+1 scribble/example On Fri, Dec 11, 2015 at 4:33 PM, Matthew Flatt <[email protected]> wrote:
> At Fri, 11 Dec 2015 13:25:25 -0800, Alexis King wrote: > > I’ve noticed the recent addition of scribble/examples to scribble-lib. > First > > of all, I’m super excited about having a more robust interface to > > scribble/eval, and from the documentation, it looks great. > > Thanks for taking a look! In retrospect, I should have made this a pull > request, because I'd really like others to take a close look. > > Besides reconsidering the library name (as below), you may think of > other simplifications, improvements, or better names. Try it out on > your documentation, but let's agree that the API might be in flux for a > little while. > > > I do have a couple questions, though. > > > > 1. Should the name of this module be scribble/examples or > > scribble/example, given that the style guide recommends only > singular > > names? I get that in this case, it might make sense to have the > plural > > name since the form it exports is called `examples`, but I figured > I’d > > raise the question before the name is set in stone. > > I agree that `scribble/example` is the right name according to the > style guide. I broke the rule here on purpose, because the main export > of `scribble/examples` is `examples`, and the mismatch between > `examples` and `scribble/example` bothered me. > > I am not sure I made the right choice in breaking the guideline, > though. If other think that `scribble/example` would be better, I can > easily agree. > > > 2. Is eval:check “fixed”? It seemed to be completely broken when I > tried > > it a number of months ago. I fixed it to at least work, but the > source > > location information was screwy. Now, though, it seems to work > okay. > > Matthew, did any of the changes you made fix this issue, or am I > just > > imagining things? > > I fixed some problems with `eval:check` along the way. > > -- > You received this message because you are subscribed to the Google Groups > "Racket Developers" group. > To unsubscribe from this group and stop receiving emails from it, send an > email to [email protected]. > To post to this group, send email to [email protected]. > To view this discussion on the web visit > https://groups.google.com/d/msgid/racket-dev/566b4131.ca42420a.98fe2.5090SMTPIN_ADDED_MISSING%40mx.google.com > . > For more options, visit https://groups.google.com/d/optout. > -- You received this message because you are subscribed to the Google Groups "Racket Developers" group. To unsubscribe from this group and stop receiving emails from it, send an email to [email protected]. To post to this group, send email to [email protected]. To view this discussion on the web visit https://groups.google.com/d/msgid/racket-dev/CAFUu9R5WbSKaWkPxppo7%2B90eHDOQPv%3DtoGwxO73i4UiU1FR9jQ%40mail.gmail.com. For more options, visit https://groups.google.com/d/optout.
