# Request for medium size examples in docs

**URL:** <https://racket.discourse.group/t/request-for-medium-size-examples-in-docs/2880>\
**Category:** General\
**Created:** [April 23, 2024, 5:05pm UTC](https://racket.discourse.group/t/request-for-medium-size-examples-in-docs/2880 "2024-04-23T17:05:31Z")\
**Posts on this page:** 2\
**Page:** 1

<div class="post-metadata">

**Author:** ![gus-massa](https://yyz2.discourse-cdn.com/free1/user_avatar/racket.discourse.group/gus-massa/32/507_2.png) [@gus-massa](https://racket.discourse.group/u/gus-massa)\
**Post date:** [April 23, 2024, 5:05pm UTC](https://racket.discourse.group/t/request-for-medium-size-examples-in-docs/2880/1 "2024-04-23T17:05:31Z")

</div>

A few days ago, someone posted in Hacker News a language implemented in Racket. The docs of that langueage are quite complete and explain all the details.

But when I see a post of a new language I want to see how it feels. I want to look at a few well known examples like "_Hello World!_" or "_Fibonacci_", perhaps "_99 bottles of beer_", I'm not sure which are the _mandatory_ examples. And then a few examples that show the strong and/or unusual part of the language.

Can we add a recomendation to add a section with examples to the docs of every language? How should it be called? Which examples? How many? (5? 10?)

---

<div class="post-metadata">

**Author:** ![cadence](https://yyz2.discourse-cdn.com/free1/user_avatar/racket.discourse.group/cadence/32/998_2.png) [@cadence](https://racket.discourse.group/u/cadence)\
**Post date:** [April 24, 2024, 3:13am UTC](https://racket.discourse.group/t/request-for-medium-size-examples-in-docs/2880/2 "2024-04-24T03:13:59Z")

</div>

I think Racket documentation overall really needs more examples. For example, the [6&nbsp;Formlets: Functional Form Abstraction](https://docs.racket-lang.org/web-server/formlets.html) documentation is all well and good until I get down to section 6.4 or 6.5, and then I don't know how to put any of this stuff together. Often I found myself looking on grep.app or [GitHub code search](https://github.com/search?q=formlet+language%3ARacket+NOT+repo%3Aracket%2Fweb-server+path%3A.rkt&type=code) to try to find complete examples.

In theory it would be pretty easy for me to add more examples to the docs. If I figure out how a weird function is supposed to be used, I can click the [i] in the docs to go to the source code, then paste my new example into GitHub's web editor.

I haven't done this yet but I should start doing it in the future.