"Contributing" link on racket-lang.org is busted

stevebyan · June 5, 2025, 5:03pm

I submitted an issue on GitHub to racket/racket-lang-org with the details.

stevebyan · June 5, 2025, 5:08pm

Didn't there used to be a section in the docs entitled "Building, Distributing, and Contributing to Racket"? That seems to be missing in the 8.17 docs at docs.racket-lang.org.

stevebyan · June 5, 2025, 5:09pm

Are the 8.16 docs still up somewhere?

shhyou · June 5, 2025, 6:53pm

It looks like the build failed: https://pkg-build.racket-lang.org/server/built/fail/racket-build-guide.txt

The time is now Wednesday, June 4th, 2025 8:29:44am
(/usr/bin/env PLTUSERHOME=/home/root//user PLT_PKG_BUILD_SERVICE=1 CI=true PLT_INFO_ALLOW_VARS=;PLT_PKG_BUILD_SERVICE PLTCOMPILEDROOTS=/home/root//zo: DISPLAY=:1 DISPLAY=:1 PLTSTDOUT=debug@pkg info@GC:major /usr/bin/xvfb-run -n 1 /bin/sh -c cd "/home/root/"/racket && bin/racket -MCR "/home/root/"/zo: -l- raco pkg install --jobs 2 -u --auto racket-build-guide)
Resolved "racket-build-guide" via file:///home/root//catalogs/archive/catalog
pkg: catalog response: #hash((author . "mflatt@racket-lang.org") (checksum . "95d575a75b9147ae87c848062206c865f7f2d9ea") (dependencies . (("base") ("scribble-lib") ("racket-doc") ("scribble-doc") ("distro-build-doc"))) (description . "Racket build and contribution documentation") (modules . ((lib "racket-build-guide/bootstrap.scrbl") (lib "racket-build-guide/distribute.scrbl") (lib "racket-build-guide/common.rkt") (lib "racket-build-guide/racket-build-guide.scrbl") (lib "racket-build-guide/zuo.scrbl") (lib "racket-build-guide/contribute.scrbl") (lib "racket-build-guide/build.scrbl"))) (name . "racket-build-guide") (ring . 1) (source . "file:///home/root/catalogs/archive/pkgs/racket-build-guide.zip") (tags . ()))
Resolved "distro-build-doc" via file:///home/root//catalogs/archive/catalog
pkg: catalog response: #hash((author . "mflatt@racket-lang.org") (checksum . "d604a68e5e43dc241d69f57be0fcf6e90e6773c6") (dependencies . (("base" #:version "6.1.1.6") ("distro-build-server") ("distro-build-client") ("web-server-lib") ("at-exp-lib") ("racket-doc") ("scribble-lib"))) (description . "documentation part of \"distro-build\"") (modules . ((lib "distro-build/distro-build.scrbl"))) (name . "distro-build-doc") (ring . 0) (source . "file:///home/root/catalogs/archive/pkgs/distro-build-doc.zip") (tags . ()))
00: Resolved "distro-build-server" via file:///home/root//catalogs/archive/catalog
Resolved "distro-build-client" via file:///home/root//catalogs/archive/catalog
pkg: catalog response: #hash((author . "mflatt@racket-lang.org") (checksum . "21b0dd5ed7a40b518667db7c1ea9ee438674e93d") (dependencies . (("base" #:version "8.14.0.2") ("distro-build-client") ("web-server-lib" #:version "1.6") ("ds-store-lib") ("net-lib") ("scribble-html-lib") ("plt-web-lib") ("remote-shell-lib" #:version "1.6") ("at-exp-lib") ("rackunit-lib"))) (description . "server-side part of \"distro-build\"") (modules . ()) (name . "distro-build-server") (ring . #f) (source . "file:///home/root/catalogs/archive/pkgs/distro-build-server.zip") (tags . ()))
pkg: catalog response: #hash((author . "mflatt@racket-lang.org") (checksum . "b39fc99a254013e4300f98a272b02e699011841a") (dependencies . (("base" #:version "6.2.900.9") ("ds-store-lib") ("at-exp-lib"))) (description . "client-side part of \"distro-build\"") (modules . ()) (name . "distro-build-client") (ring . #f) (source . "file:///home/root/catalogs/archive/pkgs/distro-build-client.zip") (tags . ()))
00: Resolved "plt-web-lib" via file:///home/root//catalogs/archive/catalog
Resolved "remote-shell-lib" via file:///home/root//catalogs/archive/catalog
pkg: catalog response: #hash((author . "eli@racket-lang.org mflatt@racket-lang.org samth@racket-lang.org") (checksum . "d0003a7cc8f640a26d6d8e69c269f402a31ca4a8") (dependencies . (("base") ("at-exp-lib") ("scribble-html-lib"))) (description . "PLT web page style and generation") (modules . ()) (name . "plt-web-lib") (ring . #f) (source . "file:///home/root/catalogs/archive/pkgs/plt-web-lib.zip") (tags . ()))
pkg: catalog response: #hash((author . "mflatt@racket-lang.org") (checksum . "60091a511f570ceadbd91515d3dfaa7a0fb56498") (dependencies . (("base"))) (description . "implementation (no documentation) part of \"remote-shell\"") (modules . ()) (name . "remote-shell-lib") (ring . #f) (source . "file:///home/root/catalogs/archive/pkgs/remote-shell-lib.zip") (tags . ()))
pkg: creating single-collection link to #<path:/home/root//user/.local/share/racket/8.17/pkgs/plt-web-lib>
pkg: updating db with "plt-web-lib" to '#s((sc-pkg-info pkg-info 3) (catalog "plt-web-lib" "git://github.com/racket/plt-web/?path=plt-web-lib#e06442a897ede8df9706555eee51734a9cecf4ab") "d0003a7cc8f640a26d6d8e69c269f402a31ca4a8" #t "plt-web")
pkg: creating single-collection link to #<path:/home/root//user/.local/share/racket/8.17/pkgs/remote-shell-lib>
pkg: updating db with "remote-shell-lib" to '#s((sc-pkg-info pkg-info 3) (catalog "remote-shell-lib" "git://github.com/racket/remote-shell/?path=remote-shell-lib#6ddcb78eea71cf5a87c83f5a0229edfb16620c28") "60091a511f570ceadbd91515d3dfaa7a0fb56498" #t "remote-shell")
pkg: creating single-collection link to #<path:/home/root//user/.local/share/racket/8.17/pkgs/distro-build-client>
pkg: updating db with "distro-build-client" to '#s((sc-pkg-info pkg-info 3) (catalog "distro-build-client" "git://github.com/racket/distro-build/?path=distro-build-client#dc7a0c38652763febbd43b69d27314f221cd3b19") "b39fc99a254013e4300f98a272b02e699011841a" #t "distro-build")
pkg: creating single-collection link to #<path:/home/root//user/.local/share/racket/8.17/pkgs/racket-build-guide>
pkg: updating db with "racket-build-guide" to '#s((sc-pkg-info pkg-info 3) (catalog "racket-build-guide") "95d575a75b9147ae87c848062206c865f7f2d9ea" #f "racket-build-guide")
pkg: creating single-collection link to #<path:/home/root//user/.local/share/racket/8.17/pkgs/distro-build-doc>
pkg: updating db with "distro-build-doc" to '#s((sc-pkg-info pkg-info 3) (catalog "distro-build-doc") "d604a68e5e43dc241d69f57be0fcf6e90e6773c6" #t "distro-build")
pkg: creating single-collection link to #<path:/home/root//user/.local/share/racket/8.17/pkgs/distro-build-server>
pkg: updating db with "distro-build-server" to '#s((sc-pkg-info pkg-info 3) (catalog "distro-build-server" "git://github.com/racket/distro-build/?path=distro-build-server#dc7a0c38652763febbd43b69d27314f221cd3b19") "21b0dd5ed7a40b518667db7c1ea9ee438674e93d" #t "distro-build")
The following uninstalled packages were listed as dependencies
and they were automatically installed:
 dependencies of racket-build-guide:
   distro-build-doc
 dependencies of distro-build-doc:
   distro-build-server
   distro-build-client
 dependencies of distro-build-server:
   plt-web-lib
   remote-shell-lib
raco setup: version: 8.17
raco setup: platform: x86_64-linux-natipkg [cs]
raco setup: target machine: any
raco setup: cross-installation: yes
raco setup: installation name: 8.17
raco setup: variants: cs
raco setup: main collects: /home/root/racket/collects/
raco setup: collects paths: 
raco setup:   /home/root/user/.local/share/racket/8.17/collects
raco setup:   /home/root/racket/collects/
raco setup: main pkgs: /home/root/racket/share/pkgs
raco setup: pkgs paths: 
raco setup:   /home/root/racket/share/pkgs
raco setup:   /home/root//user/.local/share/racket/8.17/pkgs
raco setup: links files: 
raco setup:   /home/root/racket/share/links.rktd
raco setup:   /home/root//user/.local/share/racket/8.17/links.rktd
raco setup: compiled-file roots: 
raco setup:   /home/root//zo
raco setup:   same
raco setup: main docs: /home/root/racket/doc
raco setup: --- updating info-domain tables ---                    [8:29:46]
raco setup: updating: /home/root/user/.local/share/racket/8.17/share/info-cache.rktd
raco setup: --- pre-installing collections ---                     [8:29:46]
raco setup: --- installing foreign libraries ---                   [8:29:46]
raco setup: --- installing shared files ---                        [8:29:46]
raco setup: --- compiling collections ---                          [8:29:46]
raco setup: --- parallel build using 2 jobs ---                    [8:29:46]
raco setup: 1 making: <pkgs>/distro-build-client
raco setup: 0 making: <pkgs>/distro-build-doc
/home/root/user/.local/share/racket/8.17/pkgs/distro-build-doc/distro-build.scrbl:8:21: cannot open module file
  module path: distro-build/main-distribution
  path: /home/root/user/.local/share/racket/8.17/pkgs/distro-build-client/main-distribution.rkt
  system error: no such file or directory; rkt_err=3
  compilation context...:
   /home/root/user/.local/share/racket/8.17/pkgs/distro-build-doc/distro-build.scrbl
  location...:
   /home/root/user/.local/share/racket/8.17/pkgs/distro-build-doc/distro-build.scrbl:8:21
  context...:
   /home/root/racket/collects/compiler/private/cm-minimal.rkt:700:0: compile-zo*
   /home/root/racket/collects/compiler/private/cm-minimal.rkt:634:0: compile-zo*/cross-compile
   /home/root/racket/collects/compiler/private/cm-minimal.rkt:450:15
   /home/root/racket/collects/compiler/private/cm-minimal.rkt:436:12: build
   /home/root/racket/collects/compiler/private/cm-minimal.rkt:407:0: maybe-compile-zo
   /home/root/racket/collects/compiler/private/cm-minimal.rkt:210:0: compile-root
   /home/root/racket/collects/compiler/private/cm-minimal.rkt:105:4
   /home/root/racket/collects/setup/parallel-build.rkt:385:9
   /home/root/racket/collects/setup/parallel-do.rkt:471:25
   /home/root/racket/collects/setup/parallel-do.rkt:457:20: loop
raco setup: 0 making: <pkgs>/distro-build-server
raco setup: 1 making: <pkgs>/plt-web-lib
raco setup: 1 making: <pkgs>/plt-web-lib/private
raco setup: 1 making: <pkgs>/plt-web-lib/resources
raco setup: 1 making: <pkgs>/racket-build-guide
raco setup: 1 making: <pkgs>/remote-shell-lib
raco setup: --- creating launchers ---                             [8:29:49]
raco setup: --- installing man pages ---                           [8:29:49]
raco setup: --- building documentation ---                         [8:29:49]
raco setup: 1 running: <pkgs>/distro-build-doc/distro-build.scrbl
/home/root/user/.local/share/racket/8.17/pkgs/distro-build-doc/distro-build.scrbl:8:21: cannot open module file
  module path: distro-build/main-distribution
  path: /home/root/user/.local/share/racket/8.17/pkgs/distro-build-client/main-distribution.rkt
  system error: no such file or directory; rkt_err=3
  location...:
   /home/root/user/.local/share/racket/8.17/pkgs/distro-build-doc/distro-build.scrbl:8:21
  context...:
   /home/root/racket/share/pkgs/racket-index/setup/scribble.rkt:1628:27

  context...:
   /home/root/racket/collects/setup/parallel-do.rkt:344:4: work-done method in list-queue%
   /home/root/racket/collects/setup/parallel-do.rkt:292:17
   /home/root/racket/collects/setup/parallel-do.rkt:246:4
   /home/root/racket/share/pkgs/racket-index/setup/scribble.rkt:139:0: setup-scribblings
   /home/root/racket/collects/setup/setup.rkt:78:3
   /home/root/racket/collects/pkg/main.rkt:18:0: setup
   body of (submod "/home/root/racket/collects/pkg/main.rkt" main)
   /home/root/racket/collects/raco/raco.rkt:41:0
   body of "/home/root/racket/collects/raco/raco.rkt"
   body of "/home/root/racket/collects/raco/main.rkt"
raco setup: 1 running: <pkgs>/racket-index/scribblings/main/user/local-redirect.scrbl
raco setup: 1 running: <pkgs>/racket-build-guide/racket-build-guide.scrbl
raco setup: 1 running: <pkgs>/racket-index/scribblings/main/user/release.scrbl
raco setup: 1 running: <pkgs>/racket-index/scribblings/main/user/search.scrbl
raco setup: 1 running: <pkgs>/racket-index/scribblings/main/user/start.scrbl
raco setup: WARNING: undefined tag in <pkgs>/racket-build-guide/racket-build-guide.scrbl:
raco setup:  (mod-path "distro-build/main-distribution")
raco setup:  (part ("(lib distro-build/distro-build.scrbl)" "top"))
raco setup: 1 rendering: <pkgs>/racket-index/scribblings/main/user/local-redirect.scrbl
raco setup: 0 rendering: <pkgs>/racket-build-guide/racket-build-guide.scrbl
raco setup: 0 rendering: <pkgs>/racket-index/scribblings/main/user/release.scrbl
raco setup: 1 rendering: <pkgs>/racket-index/scribblings/main/user/search.scrbl
raco setup: 0 rendering: <pkgs>/racket-index/scribblings/main/user/start.scrbl
raco setup: --- installing collections ---                         [8:29:57]
raco setup: --- post-installing collections ---                    [8:29:57]
raco setup: --- summary of errors ---                              [8:29:57]
raco setup: error: during making for <pkgs>/distro-build-doc
raco setup:   /home/root/user/.local/share/racket/8.17/pkgs/distro-build-doc/distro-build.scrbl:8:21: cannot open module file
raco setup:     module path: distro-build/main-distribution
raco setup:     path: /home/root/user/.local/share/racket/8.17/pkgs/distro-build-client/main-distribution.rkt
raco setup:     system error: no such file or directory; rkt_err=3
raco setup:     compiling: <pkgs>/distro-build-doc/distro-build.scrbl
raco setup: error: during building docs for <pkgs>/distro-build-doc/distro-build.scrbl
raco setup:   /home/root/user/.local/share/racket/8.17/pkgs/distro-build-doc/distro-build.scrbl:8:21: cannot open module file
raco setup:     module path: distro-build/main-distribution
raco setup:     path: /home/root/user/.local/share/racket/8.17/pkgs/distro-build-client/main-distribution.rkt
raco setup:     system error: no such file or directory; rkt_err=3
raco setup:     location...:
raco setup:      /home/root/user/.local/share/racket/8.17/pkgs/distro-build-doc/distro-build.scrbl:8:21
raco setup:     context...:
raco setup:      /home/root/racket/share/pkgs/racket-index/setup/scribble.rkt:1628:27
raco setup:   
racket pkg install: packages installed, although setup reported errors
GC: 0:atexit peak 326,149K(+136,314K); alloc 7,438,353K; major 6; minor 417; 3673ms
The time is now Wednesday, June 4th, 2025 8:29:57am

spdegabrielle · June 6, 2025, 1:16am

In the short term it is also available here:

github.com/racket/racket

build.md

master

# Building, Distributing, and Contributing to Racket

The main Racket source code repository is

[https://github.com/racket/racket](https://github.com/racket/racket)

This guide explains how to build those sources, how to create Racket
distributions like the ones at
[https://download.racket-lang.org](https://download.racket-lang.org),
and how to contribute to Racket development.

If you’re reading this document in Markdown form, you may find the
[online HTML
version](https://docs.racket-lang.org/racket-build-guide/index.html)
more readable. There’s no guarantee that the online version is still
available or matches the Racket sources you’re using, however.

> [1 Building Racket from Source](#1-building-racket-from-source)  
>> [1.1 Git Repository versus Source Distribution](#11-git-repository-versus-source-distribution)  
>> [1.2 Git Repository Build Modes](#12-git-repository-build-modes)

This file has been truncated. show original

Thank you for logging the issue

Topic		Replies	Views
Contributing to Racket General	19	560	July 13, 2024
Why doesn't my package have documentation link on pkgs.racket-lang.org Questions & Answers package	2	322	November 17, 2021
Looking for system admin help for the package system General	0	239	December 7, 2021
Fail to build 8.16 with Nix for docs failure Distro Packagers question , documentation	3	80	March 9, 2025
Why is the official org website down? General question , drracket	2	280	August 14, 2023

"Contributing" link on racket-lang.org is busted

Related topics