Stream: contributing

Topic: Docathon?


view this post on Zulip Aurélien Geron (Oct 13 2026 at 00:01):

Now that the language seems pretty stable, it might be time to organize a docathon to update all the docs? Perhaps a few volunteers can prepare a list of docs to update/write and provide some general instructions, then anyone can contribute over a weekend or a week?

view this post on Zulip Luke Boswell (Oct 13 2026 at 00:17):

Is the langref link to the website broken? the langref is complete, but the website says it is heavily WIP and there is a lot missing i.e

website

image.png

repository

image.png

view this post on Zulip Luke Boswell (Oct 13 2026 at 00:18):

Other than the Tutorial which Richard has said he wants to write ... what other docs need updating?

view this post on Zulip Aurélien Geron (Oct 13 2026 at 04:31):

Yeah, it's this sentence "This is heavily WIP!" that made me think we need to complete/update the docs before 0.1.0. If the langref is already done, great! :grinning_face_with_smiling_eyes:

I ran into a number of outdated statements here and there, such as saying that an if must always have an else, even though this is no longer true since we have return now.

The playground is also outdated, I'm not sure why (I thought we had fixed that).

The examples page feels disorganized. It should perhaps be organized by categories, and/or examples should perhaps have tags about their main concepts or main API.

Things feel a bit disjointed: perhaps the langref and standard lib docs should point to examples, and vice versa.

Also, several things are not covered by examples, if I'm not mistaken:

Moreover, having some examples of common packages and platforms would be good, such as unicode (in more depth), path, roc-ray, etc. Alternatively we could just point to these packages, but right now we have examples for basic-cli, basic-webserver, http, roc-ascii, roc-parser, and roc-random, so I think it would make sense. The platform and package examples should each be in their own section in the examples page.

Perhaps a "Tips and tricks" or "Best practices" page would be useful, and a docathon would help figure out what to recommend. For example I like to use Try(Foo, _) during dev and be more specific only at the end, switching to Try(Foo, [A, B, C]).

There's certainly more to do. Completing this To-Do list is what I suggested for step 1. Perhaps there's not enough work to justify step 2, but in many projects I've worked on, the docs weren't get enough love, and I've found that a short focused effort is a good solution to solve that.

view this post on Zulip Luke Boswell (Oct 13 2026 at 04:45):

Richard Feldman said:

The focus from there would be fixing bugs without regressing other things, which I'd like to do by getting a corpus of projects that work on RC1, and having CI tell us when we have broken them in a nightly release.

The broader examples might tie in nicely with the new requirement we have for testing things outside the repository -- the failing examples would tell us when we have broken things downstream, but also not block PRs.

view this post on Zulip Luke Boswell (Oct 13 2026 at 04:48):

I've been setting up my CI workflows so I can know when a nightly breaks something (either I need to patch the platform and make a new release, or report a bug back upstream).

view this post on Zulip Aurélien Geron (Oct 13 2026 at 04:50):

I'm happy to submit a few new examples. Btw, several examples are in the examples repo but not online (e.g., custom literals, hello web, webapps with Elm, sorting strings, multiline-comments)

view this post on Zulip Luke Boswell (Oct 13 2026 at 04:57):

The website and CI supporting that definitely need some love :smile:

view this post on Zulip Aurélien Geron (Oct 13 2026 at 05:05):

The benefits of a docathon go beyond simply improving the docs: it can be a fun community-building activity, an opportunity to discover & discuss other issues, and a way to get people to care more about docs if they've contributed to them.

view this post on Zulip Aurélien Geron (Oct 13 2026 at 05:21):

Apparently the reason why the website is still using an old playground and is missing several examples is that the latest Cloudflare production build failed. I'm not sure who has the Cloudflare logins, but they are needed to access the Cloudflare logs to determine what the problem is.
ChatGPT suggests that a likely build blocker is builtin documentation generation: main still uses the old command, while PR #157 switches to the required roc docs --builtins.

view this post on Zulip Anton (Oct 13 2026 at 12:38):

I am looking at the cloudflare build failure, the website is out of date because of the large amount of breaking Roc changes, things that break after updating and other random issues.

view this post on Zulip Anton (Oct 13 2026 at 12:41):

it might be time to organize a docathon to update all the docs?

Richard mentioned (I'm paraphrasing) in the last meetup that he's opinionated about the docs, so we want to make sure that we're not just filling out the docs in a distributed effort.

view this post on Zulip Anton (Oct 13 2026 at 14:34):

The website has been successfully updated :tada:

view this post on Zulip Aurélien Geron (Oct 13 2026 at 17:59):

Sounds good, thanks @Anton.

view this post on Zulip TeaDrinkingProgrammer (Oct 14 2026 at 06:57):

As I mentioned previously, I would like to contribute too, but I don't write Roc (yet) so feel free to tag me as a reviewer. Might even be helpful to have a perspective from someone who is not in the weeds as much. I'll also see id I can push my previous feedback as PRs

view this post on Zulip Aurélien Geron (Oct 15 2026 at 10:15):

I've submitted PR #163 to organize the Examples page into sections and give each example a little description:

image.png

view this post on Zulip Aurélien Geron (Oct 15 2026 at 10:24):

I also submitted PR #310 with 26 new examples covering more Roc language features, packages, and platforms:

Types and functions

Collections and iteration

Error handling

Parsing and encoding

Organizing and publishing code

Packages

Platforms

view this post on Zulip Aurélien Geron (Oct 15 2026 at 10:40):

I put them all in one PR for convenience, but if you want me to break it into smaller chunks, please let me know.

view this post on Zulip Anton (Oct 18 2026 at 17:28):

Aurélien Geron said:

I put them all in one PR for convenience, but if you want me to break it into smaller chunks, please let me know.

Yes please :sweat_smile: I'd love to be able to get quick reviews done between other things.
Thanks for making all of them :heart:

view this post on Zulip Aurélien Geron (Oct 19 2026 at 02:08):

No problem @Anton , I just submitted 26 PRs (#316 to #341), and closed the big one (#310). It's more digestible now. :sweat_smile:

view this post on Zulip TeaDrinkingProgrammer (Oct 25 2026 at 09:30):

Anybody has time to look at this one or is the mini-tutorial going to be replaced? https://github.com/roc-lang/roc/pull/11729

view this post on Zulip Anton (Oct 25 2026 at 18:17):

Yes, we indeed plan to replace it before 0.1

view this post on Zulip Aurélien Geron (Oct 27 2026 at 22:25):

There are 15 new code examples on the website, check them out!

Thanks to @Anton who reviewed them all, and to @Luke Boswell for reviewing the PR to update the website.

view this post on Zulip Luke Boswell (Oct 27 2026 at 22:25):

Love your work polishing all these examples and sharing that with the community. I am sure many people will find this helpful to follow Roc 0.1 and all the changes in our new compiler.

view this post on Zulip Hardy (Oct 28 2026 at 21:50):

Currently browsing through those examples. Very nice so far.
Found a minor bug: the link on the https://www.roc-lang.org/examples/RecursiveTypes/README page towards the nested types example is broken (i.e. there is an ".md" at the url end) and also the other direction the link on the nested to the recursive types page.

view this post on Zulip Aurélien Geron (Oct 28 2026 at 22:00):

Thanks Hardy, I'll fix these.

view this post on Zulip Luke Boswell (Oct 28 2026 at 22:02):

I was just looking at our syntax highlighting on the website... I feel like we could replace it with the tree-sitter wasm module and that would give us more fidelity and better highlighting. I'm not sure about the trade-off and haven't looked into it. Or perhaps we could use roc-parser now that has Roc syntax. Just leaving the thought here, I might look at this and explore the options later.

view this post on Zulip Richard Feldman (Oct 28 2026 at 23:23):

I'd rather not do that

view this post on Zulip Richard Feldman (Oct 28 2026 at 23:24):

I already ported our real tokenizer to JS and simplified the code to get it to a small asset size

view this post on Zulip Richard Feldman (Oct 28 2026 at 23:24):

I think if we switched to tree-sitter we would end up with a bigger asset, that ran slower (bc wasm is async so there would be a flash of unstyled content) and with actually less fidelity than what we have now :smile:

view this post on Zulip Luke Boswell (Oct 28 2026 at 23:24):

Alg, I just though the current highlighting could be better (as compared to tree-sitter etc) but I didn't look into it.

view this post on Zulip Luke Boswell (Oct 28 2026 at 23:25):

We could just improve the JS I guess, it's probably not hard

view this post on Zulip Luke Boswell (Oct 28 2026 at 23:26):

Do you remember which repository has all that?

view this post on Zulip Luke Boswell (Oct 28 2026 at 23:27):

found it

view this post on Zulip Luke Boswell (Oct 28 2026 at 23:38):

I forgot I already did a heap of work on our zig compiler semantic tokens -- so I can just re-use that in a differential harness to help improve the JS.

view this post on Zulip Luke Boswell (Oct 28 2026 at 23:38):

That uses type checked CIR as the authority.

view this post on Zulip Richard Feldman (Oct 28 2026 at 23:45):

cool, sounds good!

view this post on Zulip Luke Boswell (Oct 29 2026 at 00:15):

Didn't take long at all.. this is the home page after the first pass

image.png

view this post on Zulip Aurélien Geron (Oct 29 2026 at 00:16):

Very nice! The dark purple might be a little bit hard to read.

view this post on Zulip Richard Feldman (Oct 29 2026 at 00:25):

yeah I'm also not a fan of the yellow, if we can avoid it

view this post on Zulip Richard Feldman (Oct 29 2026 at 00:26):

I feel like purple, teal, gray, and black/white (depending on light mode vs dark mode) are uncontroversial since those are part of the color scheme, and if we really need another one, I'd go with some shade of blue that looks nice with the purple and teal

view this post on Zulip Luke Boswell (Oct 29 2026 at 00:27):

I'll iterate on it a little after lunch. I'm also adding a script that checks WCAG AA for our colors, I think we already did that and I'm not proposing we change them.

view this post on Zulip Luke Boswell (Oct 29 2026 at 00:28):

Also do we have plans to lift the tutorial back into the website from a markdown document? Even if it's just in its current form?

view this post on Zulip Aurélien Geron (Oct 29 2026 at 01:05):

FYI, I'm planning to work on these improvements to the docs in the next few days:

If you have any suggestions, please let me know!

view this post on Zulip Aurélien Geron (Oct 29 2026 at 01:40):

PR #179 moves the tutorial to the website.

view this post on Zulip Luke Boswell (Oct 29 2026 at 01:50):

I was thinking about giving the Install pages some love... but I'm not sure

view this post on Zulip Aurélien Geron (Oct 29 2026 at 01:58):

Yes, it probably needs just a little bit of text, but I like how straight-to-the-point it currently is, so we don't want a wall of text either. The "Build Roc from Source" page could also be lifted into the website.

view this post on Zulip Luke Boswell (Oct 29 2026 at 02:24):

I dont mind this pallet
image.png

view this post on Zulip Aurélien Geron (Oct 29 2026 at 02:27):

Beautiful! The dark purple is still a bit too dark for me, but I could live with it.

view this post on Zulip Aurélien Geron (Oct 29 2026 at 02:44):

image.png
The right curly bracket should be purple too.

view this post on Zulip Luke Boswell (Oct 29 2026 at 02:45):

haha already got that one :sweat_smile:

view this post on Zulip Luke Boswell (Oct 29 2026 at 02:46):

I've found a bunch of others too, doing another round of cleanup

view this post on Zulip Luke Boswell (Oct 29 2026 at 03:09):

I've been doing some research to find good categories for "semantic roles"
Screenshot from 2026-10-29 14-09-17.png

view this post on Zulip Aurélien Geron (Oct 29 2026 at 03:19):

I've done these points:

It looks like this:
image.png

Any suggestions before I submit the PR?

view this post on Zulip Luke Boswell (Oct 29 2026 at 03:22):

Looking good. I'd nitpick some alignment things, like the search bar

view this post on Zulip Aurélien Geron (Oct 29 2026 at 03:24):

Ah good point. I wanted to avoid using vertical space (especially for mobile devices), but the search bar will just scroll to the top when the user scrolls down, so that's not a problem. I'll lower it to the level of the "Docs Home" text in the panel.

view this post on Zulip Luke Boswell (Oct 29 2026 at 03:29):

Screencast from 2026-10-29 14-28-18.webm

view this post on Zulip Aurélien Geron (Oct 29 2026 at 03:32):

Very nice.

There are a few colored letters here and there (you probably noticed already):
image.png

view this post on Zulip Luke Boswell (Oct 29 2026 at 03:32):

I think thats just the recording being goofy

view this post on Zulip Luke Boswell (Oct 29 2026 at 03:44):

Here's the site preview from the PR https://semantic-highlighting-roc.cc02oj5kr.workers.dev/

view this post on Zulip Aurélien Geron (Oct 29 2026 at 04:39):

Just submitted PR #181 to add some content to the Docs landing page and keep the same header as the rest of the site. I believe I fixed the alignment issues; it now looks like this:

image.png

And on a phone:

image.png

view this post on Zulip pixelsprout (Oct 29 2026 at 04:54):

Aurélien Geron said:

Just submitted PR #181 to add some content to the Docs landing page and keep the same header as the rest of the site. I believe I fixed the alignment issues; it now looks like this:

image.png

And on a phone:

image.png

The search and hamburger don't quite line up with the content gutters. Minior nitpick though :wink:

view this post on Zulip Aurélien Geron (Oct 29 2026 at 04:58):

Oh good point, thanks, I only checked the alignment on the Desktop.

Fixed:
image.png

view this post on Zulip Steve Howell (Oct 29 2026 at 12:09):

#contributing > markdown may be relevant here.

view this post on Zulip Jonathan (Oct 29 2026 at 12:19):

Aurélien Geron said:

Just submitted PR #181 to add some content to the Docs landing page and keep the same header as the rest of the site. I believe I fixed the alignment issues; it now looks like this:

image.png

And on a phone:

image.png

I feel like this is a very minor nitpick, and it's miles better than what came before, but I haven't seen much other use of rounded corners in the rest of the roc site, and imo it jars a bit here. E.g. navigation borders, search box, Examples/FAQ section underlines, code snippets in docs. I'm not the biggest sharp-corners fan, but I did feel like it was a bit of the website's charm.

view this post on Zulip Jonathan (Oct 29 2026 at 12:19):

(Thank you for working on this!!!)

view this post on Zulip Anton (Oct 29 2026 at 14:36):

Yes, no rounded corners please, I think I once made a CI check for that. The logo is very sharp and geometric, so rounded corners don't really fit with that. Thanks for working on this though :heart:

view this post on Zulip Aurélien Geron (Oct 29 2026 at 18:54):

Sounds good, I'll tweak that. :+1:

view this post on Zulip Aurélien Geron (Oct 29 2026 at 19:50):

Here's the new look without rounded corners:

image.png

view this post on Zulip Anton (Oct 29 2026 at 20:01):

I like it :)

view this post on Zulip Anton (Oct 29 2026 at 20:09):

One minor thing I would change is "join the community". It asks for immediate commitment, the reader may not feel ready to join the community and have doubts about what that will set in motion. "Take a look at our group chat" is low commitment and super clear about what the link will do. In most places mentioning the group chat we also add "we're friendly!", because that's not always the case for online communities.

view this post on Zulip Aurélien Geron (Oct 29 2026 at 20:19):

Should "take a look at our group chat" point to the Community page or directly to Zulip?

view this post on Zulip Aurélien Geron (Oct 29 2026 at 21:00):

Here's a quick demo of the new search experience I've been building:

new-search.mov

I submitted two PRs:

Hope you like it!

view this post on Zulip Steve Howell (Oct 29 2026 at 21:02):

Looks great!

view this post on Zulip notramo (Oct 29 2026 at 21:33):

@Aurélien Geron, did you change the sorting somehow, or is this issue still relevant?
https://github.com/roc-lang/roc/issues/11522

view this post on Zulip Aurélien Geron (Oct 29 2026 at 21:37):

There's a ranking algorithm now, but it doesn't put type names first, so let me fix that.

view this post on Zulip Aurélien Geron (Oct 29 2026 at 22:10):

Fixed. :+1: I also prioritized matches at the beginning rather than the middle of a result, so Hasher comes before Crypto.BLAKE3.Hasher. Here's an example:

image.png

view this post on Zulip notramo (Oct 29 2026 at 22:17):

Thanks.

view this post on Zulip notramo (Oct 29 2026 at 22:17):

Is there some preview deployment where it can be tried out?

view this post on Zulip Aurélien Geron (Oct 29 2026 at 22:17):

Not yet, I'll set one up.

view this post on Zulip Aurélien Geron (Oct 29 2026 at 22:18):

Here's another example, showing that function matches come before signature matches:

image.png

view this post on Zulip Luke Boswell (Oct 29 2026 at 22:21):

If you make a PR cloudflare will make a preview site

view this post on Zulip Luke Boswell (Oct 29 2026 at 22:22):

This is looking really great. I love all the little details you've put in to make it feel super nice.

view this post on Zulip Aurélien Geron (Oct 29 2026 at 22:24):

Great, I'll make a PR now. It combines three PRs: the Docs generator update, the search update on the website, and the website header update.

view this post on Zulip Aurélien Geron (Oct 29 2026 at 22:33):

https://github.com/roc-lang/www.roc-lang.org/pull/184

view this post on Zulip Aurélien Geron (Oct 29 2026 at 22:33):

@Luke Boswell will Cloudflare automatically generate a preview or do you need to authorize it?

view this post on Zulip Luke Boswell (Oct 29 2026 at 22:50):

Trying to figure out why the bot triggered on my PR but not yours so far https://github.com/roc-lang/www.roc-lang.org/pull/180#issuecomment-6487202201

view this post on Zulip Luke Boswell (Oct 29 2026 at 22:51):

I marked your's ready for review to see if that helps

view this post on Zulip Luke Boswell (Oct 29 2026 at 22:51):

Ah it must be because your PR is from a fork

view this post on Zulip Aurélien Geron (Oct 29 2026 at 23:07):

Here's the new Docs search preview

view this post on Zulip notramo (Oct 29 2026 at 23:07):

image.png

I think the double border around the category selector buttons is too dense. What about removing the rounded button borders and only adding a vertical separator from the top line to the ones below?

Something like this:
image.png

view this post on Zulip Aurélien Geron (Oct 29 2026 at 23:08):

Good idea, I'll do that now

view this post on Zulip notramo (Oct 29 2026 at 23:09):

I forgot the background highlight on the active button.

view this post on Zulip Aurélien Geron (Oct 29 2026 at 23:11):

Yeah, I was thinking the same thing just now. I'll try out some things.

view this post on Zulip notramo (Oct 29 2026 at 23:12):

Or maybe no vertical bars, just some small separator like a middle dot? ·

view this post on Zulip notramo (Oct 29 2026 at 23:13):

Or keep the lower border and simply add a thicker bottom border, like this?
https://daisyui.com/components/tab/#tabs-border

view this post on Zulip notramo (Oct 29 2026 at 23:17):

image.png

The titles are not very distinct visually. Maybe a bold font would help?

view this post on Zulip notramo (Oct 29 2026 at 23:18):

image.png
The bottom border disappears when scrolling. I did not notice it when I recommended the above button border changes.

view this post on Zulip Aurélien Geron (Oct 29 2026 at 23:19):

I'm trying center dots, no lines + underline selected + darker snippets (so the titles stand out more).

view this post on Zulip Aurélien Geron (Oct 29 2026 at 23:22):

It looks like this:

image.png

view this post on Zulip notramo (Oct 29 2026 at 23:23):

Seems better. The snippet button is a bit strange. Maybe no background?

view this post on Zulip notramo (Oct 29 2026 at 23:24):

The "All" category seems good at first, but when I actually try to use it, it's not really useful. Most of the time, there are too many API results, so I would not scroll for the guides, but use the button.

What about removing it, and adding counters to the API and the guides buttons instead?

And maybe a quick button at the end of API results: That's all. Maybe try searching the Guides & examples (15) instead?

view this post on Zulip Aurélien Geron (Oct 29 2026 at 23:25):

Oh you've got a good eye, I didn't even notice the background! :glasses:

I'll remove the background. I much prefer this look, thanks for the suggestions!

Btw, would you prefer a bit more margin between the results and the buttons?

image.png

view this post on Zulip notramo (Oct 29 2026 at 23:26):

image.png
The search cancel button is not well visible. Maybe use the same purple? Or add some background?

view this post on Zulip notramo (Oct 29 2026 at 23:26):

Btw, would you prefer a bit more margin between the results and the buttons?

Yes, I would recommend that. Maybe if a fade or shadow effect could be added, that would help.

view this post on Zulip notramo (Oct 29 2026 at 23:27):

I would recommend symmetric padding at the top of the buttons too.

view this post on Zulip Aurélien Geron (Oct 29 2026 at 23:44):

Hows' this?

image.png

I'm not sure about removing the All button. I've used the search for a while, and what I liked is that pretty often what I'm looking for is right there, without extra clicks. For the API results, they're at the top, so no problem. But when I search for lang ref content, such as "Modules", "Platforms", or "Types", there are barely any API results so the thing I'm looking for is right there. And in the cases it's not (e.g., "JSON"), I just need to click on "Guides & examples", which I would have to do anyway if we removed "All".

view this post on Zulip notramo (Oct 29 2026 at 23:45):

Seems good.

view this post on Zulip notramo (Oct 29 2026 at 23:46):

What is the thick bar under the snippets button?

view this post on Zulip notramo (Oct 29 2026 at 23:46):

Is it indicating that it's enabled/disabled?

view this post on Zulip Aurélien Geron (Oct 29 2026 at 23:46):

Yes

view this post on Zulip Aurélien Geron (Oct 29 2026 at 23:46):

It's off by default so the user will see the underline appear when clicking it

view this post on Zulip notramo (Oct 29 2026 at 23:46):

What about using a toggle for it?

view this post on Zulip notramo (Oct 29 2026 at 23:46):

https://daisyui.com/components/toggle/#toggle-switch

view this post on Zulip notramo (Oct 29 2026 at 23:47):

By the way, is the docs vanilla CSS or is some UI framework used?

view this post on Zulip notramo (Oct 29 2026 at 23:47):

Then I could link component examples from that (if any).

view this post on Zulip Aurélien Geron (Oct 29 2026 at 23:48):

It's vanilla CSS and JS

view this post on Zulip Aurélien Geron (Oct 29 2026 at 23:49):

I initially had a "Show snippet" button (which would be roughly as wide as a toggle + label), and it made the button bar too wide on mobile, they ended up on two lines

view this post on Zulip notramo (Oct 29 2026 at 23:49):

Maybe a "Snippets" plus a toggle?

view this post on Zulip notramo (Oct 29 2026 at 23:51):

It's confusing on mobile, because sometimes there's no visible effect when toggling it.

view this post on Zulip notramo (Oct 29 2026 at 23:53):

And there's no label either.

view this post on Zulip notramo (Oct 29 2026 at 23:54):

image.png
Maybe utilize the full screen width on mobile? So there's no blank padding at the sides?

view this post on Zulip Aurélien Geron (Oct 29 2026 at 23:55):

Sounds good, I'll give that a try.

view this post on Zulip notramo (Oct 29 2026 at 23:58):

And maybe the border could be removed and use the full screen.

view this post on Zulip notramo (Oct 29 2026 at 23:59):

Try it on a real mobile, not just the devtools mobile simulator.

view this post on Zulip notramo (Oct 29 2026 at 23:59):

When the on-screen keyboard is open during search, it uses up half of the screen.

view this post on Zulip Aurélien Geron (Oct 30 2026 at 00:00):

Trying all of this. I'm also adding snippets in the API section.

view this post on Zulip notramo (Oct 30 2026 at 00:03):

My recommendation for mobile:

This would hide all other parts of the page. For example, the top menu unnecessarily takes up space during search.

view this post on Zulip Aurélien Geron (Oct 30 2026 at 00:15):

It looks much better. I've also merged the two API sections into one, there's no good reason to separate them.
Next I'll work on the snippet toggle

view this post on Zulip Aurélien Geron (Oct 30 2026 at 00:23):

Here's what it looks like now on mobile. I also added the toggle:

image.png

view this post on Zulip Aurélien Geron (Oct 30 2026 at 00:35):

Here's the latest search preview.

view this post on Zulip Aurélien Geron (Oct 30 2026 at 00:38):

Looks like this on my phone, with the on-screen keyboard:
Screenshot_20261030_133726_Chrome.jpg

view this post on Zulip Aurélien Geron (Oct 30 2026 at 00:40):

And without the snippets:
Screenshot_20261030_134011_Chrome.jpg

view this post on Zulip notramo (Oct 30 2026 at 00:45):

I like this version a lot more.

view this post on Zulip notramo (Oct 30 2026 at 00:47):

image.png
When focusing it on mobile, and it switches into full-screen mode, it's empty. I would recommend showing unfiltered results ("" query string), or some top picks.

view this post on Zulip Aurélien Geron (Oct 30 2026 at 01:40):

Latest search preview with suggestions on mobile

view this post on Zulip Aurélien Geron (Oct 30 2026 at 01:43):

It looks like this:

image.png

view this post on Zulip Luke Boswell (Oct 30 2026 at 01:43):

this is just my opinion ... but it feels strange to have a super wide screen on my monitor, and then these code snippets are scrolling horizontally with so much empty whitespace

Screenshot from 2026-10-30 12-42-41.png

view this post on Zulip Luke Boswell (Oct 30 2026 at 01:44):

I'm on a 1920x1080 monitor so nothing unusual

view this post on Zulip Aurélien Geron (Oct 30 2026 at 01:45):

This is not related to my recent changes, I don't think. We could perhaps make it a bit wider indeed, but there comes a point where it looks like a wall of text and it's not as pleasant to read, imho.

view this post on Zulip Luke Boswell (Oct 30 2026 at 01:50):

Its not related to the search

view this post on Zulip Luke Boswell (Oct 30 2026 at 01:51):

I wonder if we could make a lint or something to warn if our code snippets were longer than 80 characters on a line or something

view this post on Zulip Luke Boswell (Oct 30 2026 at 01:51):

That might be a bit crude but we could always break them over multiple lines I guess.

view this post on Zulip Aurélien Geron (Oct 30 2026 at 02:10):

Yes, it would be nice if the doc for every function and type started with a short sentence that could be used as a snippet. :+1: Python imposes that, we could reuse the same rules. ChatGPT says:

view this post on Zulip Luke Boswell (Oct 30 2026 at 02:13):

Is this how Python does it?

view this post on Zulip Aurélien Geron (Oct 30 2026 at 02:13):

Yes, these are Python's rules

view this post on Zulip Luke Boswell (Oct 30 2026 at 02:15):

I wonder if we will want to tailor the "imperative command" a little for Roc's functional approach. I'm really fuzzy on what that would look like, just "Return the absolute value" doesn't quite feel right

view this post on Zulip Anton (Oct 30 2026 at 06:31):

By the way, on macOS responsively is great so you can see a wide variety of screen sizes and types at once.

view this post on Zulip Anton (Oct 30 2026 at 06:44):

Aurélien Geron said:

Should "take a look at our group chat" point to the Community page or directly to Zulip?

Directly to zulip, the community page has too much text for the casually curious.

view this post on Zulip Aurélien Geron (Oct 30 2026 at 08:05):

Oops, it looks like I forgot this change, the site still says "join our community", sorry. I just submitted PR #186 to fix that.

view this post on Zulip notramo (Oct 30 2026 at 10:52):

Is it intentional that the /tutorial page does not mention the |> even once?

view this post on Zulip notramo (Oct 30 2026 at 10:52):

Some LLMs think it's been removed in the rewrite or usage is discouraged.

view this post on Zulip Luke Boswell (Oct 30 2026 at 10:53):

It was removed, and then it came back :sweat_smile:

view this post on Zulip Luke Boswell (Oct 30 2026 at 10:53):

So not intentional, just not updated

view this post on Zulip Richard Feldman (Oct 30 2026 at 15:11):

yeah the syntax for it changed to a different symbol in the initial rewrite, then later changed back

view this post on Zulip notramo (Oct 30 2026 at 18:30):

Was the method syntax also added in the rewrite? Or did it exist in the old Rust version too?

view this post on Zulip Anton (Oct 30 2026 at 18:39):

It was added in the rewrite

view this post on Zulip Aurélien Geron (Oct 31 2026 at 04:03):

I'm now working on updating the langref. I submitted PR #12725 to fill gaps in the outline, give it more structure, clarify what exists todays vs what's planned, remove some obsolete limitations, soften the intro warning, and a few other things.

Here's the list of planned features mentioned in the langref. Now that we're approaching 0.1.0, it would be good to clarify which of these are planned for 0.1.0. @Richard Feldman?

view this post on Zulip Richard Feldman (Oct 31 2026 at 12:08):

All of those will be after 0.1.0

view this post on Zulip Aurélien Geron (Oct 31 2026 at 20:38):

Thanks, Richard. I think there are a couple of references to 0.1.0 in the langref, I'll be explicit about the fact that it will be after 0.1.0, to set expectations. Unless you want me to say "by 1.0.0"?

view this post on Zulip Richard Feldman (Oct 31 2026 at 22:01):

let's just say after 0.1.0, no need to promise things unnecessarily :smile:

view this post on Zulip Aurélien Geron (Oct 31 2026 at 22:31):

Thanks Richard. PR #12758 updates the langref to make this clear.

view this post on Zulip Aurélien Geron (Nov 01 2026 at 06:08):

The new search is live, try it out!

view this post on Zulip Anton (Nov 01 2026 at 08:02):

I like the "Try searching for..." suggestions :)


Last updated: Nov 04 2026 at 18:54 UTC