For clojure.org, the source is on GitHub, and you can submit a Pull Request (as long as you have a CA on file I believe?). The clojure.spec Guide page is:
https://github.com/clojure/clojure-site/blob/master/content/guides/spec.adoc You could draft a PR for an enhancement to the Entity Maps section… Sean Corfield -- (970) FOR-SEAN -- (904) 302-SEAN An Architect's View -- http://corfield.org/ "If you're not annoying somebody, you're not really alive." -- Margaret Atwood On 4/3/17, 2:36 PM, "Gregg Reynolds" <clojure@googlegroups.com on behalf of d...@mobileink.com> wrote: i think the spec docs could be improved; my question is whether suggestions should go into jira. one can always write a blog post, and one does not want to pollute jira. case in point: validating maps, in particular taking some action if a map contains an unrecognized key. it might be fine to do nothing, but in many cases you want to at least emit a warning. minimum case: user just misspells an optional key, and then wonders why it doesn't work. there are various ways to do this, i expect. i just discovered that you can use s/and with s/keys plus a (fn [x] .. ) predicate - but if you do not include the s/keys bit, the checker will not recur. seems to me that this kind of thing merits at least a mention in the official docs. -gregg -- You received this message because you are subscribed to the Google Groups "Clojure" group. To post to this group, send email to clojure@googlegroups.com Note that posts from new members are moderated - please be patient with your first post. To unsubscribe from this group, send email to clojure+unsubscr...@googlegroups.com For more options, visit this group at http://groups.google.com/group/clojure?hl=en --- You received this message because you are subscribed to the Google Groups "Clojure" group. To unsubscribe from this group and stop receiving emails from it, send an email to clojure+unsubscr...@googlegroups.com. For more options, visit https://groups.google.com/d/optout. -- You received this message because you are subscribed to the Google Groups "Clojure" group. To post to this group, send email to clojure@googlegroups.com Note that posts from new members are moderated - please be patient with your first post. To unsubscribe from this group, send email to clojure+unsubscr...@googlegroups.com For more options, visit this group at http://groups.google.com/group/clojure?hl=en --- You received this message because you are subscribed to the Google Groups "Clojure" group. To unsubscribe from this group and stop receiving emails from it, send an email to clojure+unsubscr...@googlegroups.com. For more options, visit https://groups.google.com/d/optout.
