# Revising READMEs **URL:** \ **Category:** Internals\ **Created:** [July 20, 2023, 3:18pm UTC](https://racket.discourse.group/t/revising-readmes/2120 "2023-07-20T15:18:29Z")\ **Posts on this page:** 5\ **Page:** 1
**Author:** ![sorawee](https://avatars.discourse-cdn.com/v4/letter/s/ea5d25/32.png) [@sorawee](https://racket.discourse.group/u/sorawee)\ **Post date:** [July 20, 2023, 3:18pm UTC](https://racket.discourse.group/t/revising-readmes/2120/1 "2023-07-20T15:18:29Z")
I'm planning to revise READMEs of many repos under the Racket organization ([Racket · GitHub](http://github.com/racket/)). The goal is to make it easier for people to understand what the repo is about. It would be nice to get a brainstorm on what to do. Take [GitHub - racket/2d: 2d syntax](https://github.com/racket/2d) as an example. Here are my intended changes: - Add a few sentences to describe what the packages in the repo are implementing - Link to the documentation page - General cleanup (fix typos, etc.) Following is what I am unsure about: > Contribute to Racket by submitting a [pull request](https://github.com/racket/2d/pulls), reporting an [issue](https://github.com/racket/2d/issues), joining the [development mailing list](https://lists.racket-lang.org), or visiting the IRC or Slack channels. 1. Since this README was written, Discord becomes much more active than Slack (and IRC?). I don't think adding Discord (or replacing Slack with Discord) is a good idea though. It would be better if we don't mention any specific social platform at all, but instead link to a central page that contains the information. This makes it easy to maintain and keep it up-to-date. 2. For "development mailing list", we should definitely link to [Internals - Racket Discourse](https://racket.discourse.group/c/internals/), not [https://lists.racket-lang.org/](https://lists.racket-lang.org/). But should [https://lists.racket-lang.org/](https://lists.racket-lang.org/) also be modified to let visitors know that they are supposed to go somewhere else? ---
**Author:** ![jbclements](https://yyz2.discourse-cdn.com/free1/user_avatar/racket.discourse.group/jbclements/32/11_2.png) [@jbclements](https://racket.discourse.group/u/jbclements)\ **Post date:** [July 21, 2023, 12:41am UTC](https://racket.discourse.group/t/revising-readmes/2120/2 "2023-07-21T00:41:42Z")
I think we should 100% pivot to IRC. Sorry, couldn't help myself. 1. I think the best candidate for a central contact page here is the "community" tab of [racket-lang.org](http://racket-lang.org). I am not aware of a way to link to this tab directly, Though I have not checked out the racket-lang-org source repo, there might very well be a URL to get to this directly. 2. I think that [lists.racket-lang.org](http://lists.racket-lang.org) should have a big notice at the top, suggesting that people use the other community links... which kind of falls back to #1, a URL to link to that page. @spdegabrielle , is there a better landing page that you're aware of here? ---
**Author:** ![jbclements](https://yyz2.discourse-cdn.com/free1/user_avatar/racket.discourse.group/jbclements/32/11_2.png) [@jbclements](https://racket.discourse.group/u/jbclements)\ **Post date:** [July 21, 2023, 12:42am UTC](https://racket.discourse.group/t/revising-readmes/2120/3 "2023-07-21T00:42:03Z")
Should also have said: many thanks for tackling this! ---
**Author:** ![spdegabrielle](https://yyz2.discourse-cdn.com/free1/user_avatar/racket.discourse.group/spdegabrielle/32/95_2.png) [@spdegabrielle](https://racket.discourse.group/u/spdegabrielle)\ **Post date:** [July 21, 2023, 4:39pm UTC](https://racket.discourse.group/t/revising-readmes/2120/4 "2023-07-21T16:39:24Z")
The list page is different [https://lists.racket-lang.org](https://lists.racket-lang.org) it should direct people to [https://racket.discourse.group/](https://racket.discourse.group/) and note that is can be used as a web forum or as a mailing list. For a landing page I refer people to [https://racket-lang.org](https://racket-lang.org) but I’d prefer community to have its own page and a big link on the home page so it is easily linkable. See my finely crafted mockup; ![IMG_6674](https://global.discourse-cdn.com/free1/uploads/racket/original/2X/3/379a35cd61b361d814da6d70e129530e14ed4615.jpeg) - I don't believe it is possible to direct link to the Community tab under the Ecosystem section This is the pollen code: [https://github.com/racket/racket-lang-org/blob/a85e3ba4947314919adccdd704e36e46ae654267/www/index.html.pm#L357](https://github.com/racket/racket-lang-org/blob/a85e3ba4947314919adccdd704e36e46ae654267/www/index.html.pm#L357) ... PS: Hilariously the Racket users google group _description_ refers to a community page that no longer exists: > The Racket programming language users mailing list. See [http://racket-lang.org/community.html](http://racket-lang.org/community.html) for details. Since it is possible that people will find the google group without going to [https://lists.racket-lang.org](https://lists.racket-lang.org) I've now changed the group information: ![image](https://global.discourse-cdn.com/free1/uploads/racket/original/2X/4/49d8ff241a4699cddc9aa08906bffb7b0c52c50a.png) and the about page: ![image](https://global.discourse-cdn.com/free1/uploads/racket/original/2X/e/e95b8f2a259377adbf85db950040377bcba8b9b3.png) It would be good to do the same for 'announce' and 'dev' Google groups linked from [https://lists.racket-lang.org](https://lists.racket-lang.org), but I lack the permissions to do it myself. ... PPS Not hilarious - over 600 pending members for [https://groups.google.com/g/racket-users](https://groups.google.com/g/racket-users) as recent as this month. I am taking the following action 1. approving all 2. sending an apology message with instructions to join [https://racket.discourse.group/](https://racket.discourse.group/) 3. trying to work out how they came to be 'pending' best Stephen ---
**Author:** ![spdegabrielle](https://yyz2.discourse-cdn.com/free1/user_avatar/racket.discourse.group/spdegabrielle/32/95_2.png) [@spdegabrielle](https://racket.discourse.group/u/spdegabrielle)\ **Post date:** [July 21, 2023, 4:42pm UTC](https://racket.discourse.group/t/revising-readmes/2120/5 "2023-07-21T16:42:04Z")
never mind - they are pending invitations from 2015 that were never taken up there is only a few dozen membership requests. confusing ui. s.,