# What section of the docs would you like more examples for? **URL:** \ **Category:** Questions & Answers\ **Created:** [October 31, 2022, 4:45pm UTC](https://racket.discourse.group/t/what-section-of-the-docs-would-you-like-more-examples-for/1427 "2022-10-31T16:45:48Z")\ **Posts on this page:** 8\ **Page:** 1
**Author:** ![dstorrs](https://avatars.discourse-cdn.com/v4/letter/d/898d66/32.png) [@dstorrs](https://racket.discourse.group/u/dstorrs)\ **Post date:** [October 31, 2022, 4:45pm UTC](https://racket.discourse.group/t/what-section-of-the-docs-would-you-like-more-examples-for/1427/1 "2022-10-31T16:45:48Z")
I'm volunteering to add examples and expanded text to the Racket documentation. What would be some high-value areas to do that in? Are there particular segments of the docs that you've found hard to understand? Let me know and I'll do my best to come up with clarifications. ---
**Author:** ![brittAnderson](https://avatars.discourse-cdn.com/v4/letter/b/b5a626/32.png) [@brittAnderson](https://racket.discourse.group/u/brittAnderson)\ **Post date:** [October 31, 2022, 6:51pm UTC](https://racket.discourse.group/t/what-section-of-the-docs-would-you-like-more-examples-for/1427/2 "2022-10-31T18:51:17Z")
Most of my requests would be related to the scribble documentation. Usually the examples are most helpful when scribble mixes with something else, e.g. - including a plot in a scribble document. - including code that you want to typeset only in pieces and the same code that you want to run, e.g. when explaining an algorithm in multiple steps, but including a consolidated "run" of the code at the end. This would mostly revolve around the syntax for evaluators within scribble docs. I often find myself consulting these two blog posts for bibliographies and scribble. Making that information part of the primary documentation could be helpful. - [Writing a paper with Scribble](https://prl.ccs.neu.edu/blog/2019/02/17/writing-a-paper-with-scribble/) - [How To Use Scribble to Write your Academic Papers: A Reference Tutorial](https://dustycloud.org/misc/digital-humanities/HowTo.html) Cheers, "David K. Storrs via Racket Discussions" [notifications\_at\_racket.discoursemail.com\_txnwmxfz@duck.com](mailto:notifications_at_racket.discoursemail.com_txnwmxfz@duck.com) writes: ---
**Author:** ![dstorrs](https://avatars.discourse-cdn.com/v4/letter/d/898d66/32.png) [@dstorrs](https://racket.discourse.group/u/dstorrs)\ **Post date:** [November 1, 2022, 2:51pm UTC](https://racket.discourse.group/t/what-section-of-the-docs-would-you-like-more-examples-for/1427/3 "2022-11-01T14:51:20Z")
Huh, not what I was expecting. I haven't done much with complex Scribble, but I was expecting to need to learn something in order to do this, and in this case I can happily import things from those blog posts into the primary reference. Thanks for the links. ---
**Author:** ![sorawee](https://avatars.discourse-cdn.com/v4/letter/s/ea5d25/32.png) [@sorawee](https://racket.discourse.group/u/sorawee)\ **Post date:** [November 1, 2022, 3:47pm UTC](https://racket.discourse.group/t/what-section-of-the-docs-would-you-like-more-examples-for/1427/4 "2022-11-01T15:47:55Z")
Here's what I proposed earlier in the Hackathon. - 2htdp/image ([https://github.com/racket/htdp/issues/183](https://github.com/racket/htdp/issues/183)) - Everything in [https://docs.racket-lang.org/reference/stxtrans.html](https://docs.racket-lang.org/reference/stxtrans.html) ---
**Author:** ![dstorrs](https://avatars.discourse-cdn.com/v4/letter/d/898d66/32.png) [@dstorrs](https://racket.discourse.group/u/dstorrs)\ **Post date:** [November 1, 2022, 4:16pm UTC](https://racket.discourse.group/t/what-section-of-the-docs-would-you-like-more-examples-for/1427/5 "2022-11-01T16:16:07Z")
[humor] Me (thinking): You know, I should give back to the community. I know, I'll volunteer to do documentation! I'm sure people would like some extra examples and doc expansion on relatively commonly-used things that could still stand a few extra details, and I've plowed through a lot of that stuff already so it shouldn't be too hard. Go me, I am halping! Me: Hey folks, want some examples? People: Cool, thanks. How about these things you've never touched before? Me: Uh-oh. [/humor] ---
**Author:** ![sschwarzer](https://yyz2.discourse-cdn.com/free1/user_avatar/racket.discourse.group/sschwarzer/32/1940_2.png) [@sschwarzer](https://racket.discourse.group/u/sschwarzer)\ **Post date:** [November 1, 2022, 10:18pm UTC](https://racket.discourse.group/t/what-section-of-the-docs-would-you-like-more-examples-for/1427/6 "2022-11-01T22:18:56Z")
No surprise. That was bound to happen. 😄 ---
**Author:** ![wluker](https://avatars.discourse-cdn.com/v4/letter/w/0ea827/32.png) [@wluker](https://racket.discourse.group/u/wluker)\ **Post date:** [November 2, 2022, 3:00pm UTC](https://racket.discourse.group/t/what-section-of-the-docs-would-you-like-more-examples-for/1427/7 "2022-11-02T15:00:59Z")
[me maybe adding to your horror/humor] I think the FFI docs could use a whole lot more examples because things go boom very easily here and it's hard for a new learner to know if they got it right or wrong; until boom. ---
**Author:** ![dstorrs](https://avatars.discourse-cdn.com/v4/letter/d/898d66/32.png) [@dstorrs](https://racket.discourse.group/u/dstorrs)\ **Post date:** [November 2, 2022, 9:02pm UTC](https://racket.discourse.group/t/what-section-of-the-docs-would-you-like-more-examples-for/1427/8 "2022-11-02T21:02:17Z")
That is very unlikely to happen, but I appreciate your faith in me. :\>