Luke Boswell (Jul 03 2024 at 23:47): Luke Boswell (Jul 03 2024 at 23:47):I think we should make https://www.roc-lang.org/plans more visible. If you don't already know that page is there, I don't think it's realistically discoverable.
It's a useful resource to communicate the known breaking changes etc, in particular for anyone who is considering developing a platform.
I like that the roc repository has a big upfront statement.
Work in progress!
Roc is not ready for a 0.1 release yet, but we do have ...
I propose we add a banner to the website pages that communicates something similar.
Something like this.
Roc is a Work in Progress
See our [Plans](/plans) page for more information.
@Richard Feldman
Richard Feldman (Jul 03 2024 at 23:53):how about at the top of the downloads page?
Richard Feldman (Jul 03 2024 at 23:54):that way everyone who downloads it sees it
Luke Boswell (Jul 03 2024 at 23:54):On https://www.roc-lang.org/install?
Richard Feldman (Jul 03 2024 at 23:54):yeah
Luke Boswell (Jul 03 2024 at 23:54):How about docs?
Richard Feldman (Jul 03 2024 at 23:54):I don't love putting it on the homepage because it disrupts the learning flow for new vistors - it's like "ok what's this language about? Oh, wait, what's this? Should I go learn about future plans? I don't even know what this thing is about yet!"
Richard Feldman (Jul 03 2024 at 23:55):docs could work, although what I like about /install is that I think more people will see it
Richard Feldman (Jul 03 2024 at 23:55):people don't necessarily visit docs when reading the tutorial for example
Luke Boswell (Jul 03 2024 at 23:55):Sounds like a plan. I'll draft something up
Richard Feldman (Jul 03 2024 at 23:55):sweet, thanks! :smiley:
Luke Boswell (Jul 04 2024 at 00:39):https://github.com/roc-lang/roc/pull/6865
Kilian Vounckx (Jul 04 2024 at 07:19):I also think the plans page should be updated. I just went through it because I didn't know about it (so good thing we made it more visible)
It says work hasn't started on the new module syntax, but we are almost there. Not a big deal, but slightly inaccurate.
Weirder is that the section on glue is in there twice. Also no big deal but was confusing to me when I read it
Kilian Vounckx (Jul 04 2024 at 07:21):Oh I see now that glue is once under 'Planned breaking changes' and once under 'Platform author specific breaking changes', so maybe it is intended, but it shouldn't be under builtins right?
Kilian Vounckx (Jul 04 2024 at 07:23):I had a really hard time distinguishing between the headers and subheaders on mobile though (e.g. 'planned breaking changes' and 'glue', 'planned breaking changes' is clearly different with the underline)
Kilian Vounckx (Jul 04 2024 at 07:25):I will check later on pc, but maybe it should be changed a bit. Some context, I am color blind and when I realized they where different headers and really focused I could see they were slightly different colors. Definitely not on a first read though
Kilian Vounckx (Jul 04 2024 at 07:25):Sorry for the arguably unrelated spam :sweat_smile:
Kilian Vounckx (Jul 04 2024 at 07:49):Just checked on PC. There the differences are clear to me. I was wrong about the subheaders :sweat_smile:. 'builtins', 'glue', 'import syntax' and 'platform specific breaking changes' are all of the same header type and under the last there are multiple subheaders which is clear.
So I don't think anything should be changed, or at least not made a priority at all, because I think most people won't check the site on mobile.
Kilian Vounckx (Jul 04 2024 at 07:49):The 'glue' section is still on the page twice though
Sam Mohr (Jul 04 2024 at 07:54):Yeah, it'd be good for us to at least do a recent update on the languages plans, though better obviously would be a more consistent update to that page when big changes are made/planned. I think we could start with 2 steps:
Sam Mohr (Jul 04 2024 at 08:43):I don't think so? The closest we have is Richard Feldman, but that's just because he wears all of the hats simultaneously, like a TF2 player
Luke Boswell (Jul 04 2024 at 10:24):I was planning on making some updates to it. :smiley:
I figure I'd try and summarise what I know, only at a very rough high level. And make a PR we could discuss.
Last updated: Jun 16 2026 at 16:19 UTC