search

fonol / cl-community-spec

A Common Lisp specification, made from the original ANSI specification drafts
https://cl-community-spec.github.io
MIT License
80 stars 6 forks source link

Do you accept new examples? #10

Open jgarte opened 1 year ago

jgarte commented 1 year ago

Do you accept new examples?

For example,

I would like to contribute fresh examples for gethash on this page:

https://cl-community-spec.github.io/pages/gethash.html

fonol commented 1 year ago

I think some form of "community notes" could be a nice addition. I think it should just be very distinct, what part was added, and what part is the original spec.

How about adding a card at the end (like there already is a "Notes" card sometimes)?

I also don't know what model could work well for discussing/working together on these things (in case more than one person ever wants to contribute something)? Maybe for each page where there is a proposal to add some notes, there could be a distinct Github issue? So for your example, there could be an issue [Community Notes] gethash?

jgarte commented 10 months ago

That sounds good to me but would it not be better to have a more human editable format like markdown versus editing html by hand to introduce new changes?

I'm thinking of the way the Common Lisp Cookbook does it:

https://github.com/LispCookbook/cl-cookbook

I realize that we don't have that format currently.

WDYT