search

LuKuangChen / stacker-on-racket

A notional machine for the SMoL languages
MIT License
21 stars 1 forks source link

install docs #5

Open bremner opened 9 months ago

bremner commented 9 months ago

Similar to https://github.com/shriram/smol/issues/27 I do not see installed docs for stacker either.

I don't see any errors when running "raco pkg install Stacker"

raco setup: --- creating launchers ---                             [17:28:34]
raco setup: --- installing man pages ---                           [17:28:34]
raco setup: --- building documentation ---                         [17:28:34]
raco setup: 0 running: <pkgs>/Stacker/scribblings/stacker.scrbl
raco setup: rendering: <pkgs>/Stacker/scribblings/stacker.scrbl

A potential difference is that I am using the Debian package of racket (8.10 at the moment).

bremner commented 9 months ago

Sorry being a bit noisy here. I realized that "raco doc plait" doesn't work for me either, and I thought it used to. I started a discourse thread for a more general discussion https://racket.discourse.group/t/raco-doc-for-user-scope-installed-packages/2612

LuKuangChen commented 9 months ago

Please don't install this software. It is an old version of the web-based stacker and has been deprecated (as the README indicated).

I notice that you already have a web-based stacker running (https://www.cs.unb.ca/~bremner/teaching/cs4613/stacker/). Are you trying this old version just out of curiosity? Or you really need a DrRacket-based version?

bremner commented 9 months ago

KC Lu @.***> writes:

Please don't install this software. It is an old version of the web-based stacker and has been deprecated (as the README indicated).

Yes, I somehow missed that when filing the bug (I added stacker to my course meta package some months ago). Of course it makes sense that you don't want to maintain two versions.

I notice that you already have a web-based stacker running (https://www.cs.unb.ca/~bremner/teaching/cs4613/stacker/). Are you trying this old version just out of curiosity? Or you really need a DrRacket-based version?

For my own workflow when teaching, I use links to racket files from PDF slides. In this context the racket based stacker is more straightforward to use (it doesn't really need DrRacket, as it works fine from e.g. Emacs racket-mode). On the other hand I can probably replace that usage with appropriate links to web-stacker (which inspired me to file https://github.com/LuKuangChen/stacker-2023/issues/5).

shriram commented 9 months ago

There are SO many improvements to the Web-based stacker. For instance:

  1. Permalinks that you can share with your student, or permalinks that your students can share with you with questions. Like, "Here in the trace it says…".

  2. The Racket-based Stacker uses a fresh random seed every time; the Web Stacker uses the same random seed always (but you can change it if you like), which means if students build up a memory for some particular set of addresses, and you make a small change and re-run the program, the addresses that should be common will be.

Having used both, I can't imagine going back to the Racket-based Stacker…

LuKuangChen commented 9 months ago

For my own workflow when teaching, I use links to racket files from PDF slides. In this context the racket based stacker is more straightforward to use (it doesn't really need DrRacket, as it works fine from e.g. Emacs racket-mode). On the other hand I can probably replace that usage with appropriate links to web-stacker (which inspired me to file LuKuangChen/stacker-2023#5).

I see -- we are lacking a way to easily launch the web-stacker from Racket.

  1. Let me response to LuKuangChen/stacker-2023#5 later today.
  2. I will also make this repo a Racket lang that starts the web-stacker when run.
bremner commented 9 months ago

KC Lu @.***> writes:

For my own workflow when teaching, I use links to racket files from PDF slides. In this context the racket based stacker is more straightforward to use (it doesn't really need DrRacket, as it works fine from e.g. Emacs racket-mode). On the other hand I can probably replace that usage with appropriate links to web-stacker (which inspired me to file LuKuangChen/stacker-2023#5).

I see -- we are lacking a way to easily launch the web-stacker from Racket.

  1. Let me response to LuKuangChen/stacker-2023#5) later today.
  2. I will also make this repo a Racket lang that starts the web-stacker when run.

For the moment I figured out how to have the appropriate URL's generated in my PDF slides, so will use web-stacker instead of this #lang

In case some later reader else is interested, I will mention the emacs in a blog post.

d

bremner commented 9 months ago

David Bremner @.***> writes:

For the moment I figured out how to have the appropriate URL's generated in my PDF slides, so will use web-stacker instead of this #lang

In case some later reader else is interested, I will mention the emacs in a blog post.

The details are at

http://www.cs.unb.ca/~bremner/blog/posts/web-stacker/

Admittedly, I might be the only person who wants to do this exact thing.