Skip to content

[docs] First cut at recommending fud2 throughout #2498

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 2 commits into from
Jul 24, 2025
Merged

Conversation

sampsyo
Copy link
Contributor

@sampsyo sampsyo commented Jun 23, 2025

Here's a quick attempt to convert all the low-hanging fruit I could find in the docs to refer to fud2 instead of fud. I haven't done anything about the actual fud docs themselves, the "experimental" label, or anything like that.

Most of the changes are pretty mechanical. The only substantial bit of new writing is in the "getting started" guide, where I added a compressed overview of how to install fud2 (which is of course already explained in more detail on the main fud2 docs page).

I'm sure there's plenty more to do here, but I thought I'd just get the ball rolling!

Just an attempt to convert all the low-hanging fruit I could find in the
docs to refer to fud2 instead of fud. I haven't done anything about the
actual fud docs themselves, the "experimental" label, or anything like
that.

Most of the changes are pretty mechanical. The only substantial bit of
new writing is in the "getting started" guide, where I added a
compressed overview of how to install fud2 (which is of course already
explained in more detail on the main fud2 docs page).
Copy link
Contributor

@ayakayorihiro ayakayorihiro left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Looks great to me! (I had a small question but nothing too pressing)

@@ -142,7 +142,7 @@ But now we're controlling things with an execution schedule.

If you're curious to see how the Calyx compiler lowers this program to a Verilog-like structural form of Calyx, you can do this:

fud exec language-tutorial-mem.futil --to calyx-lowered
calyx language-tutorial-mem.futil
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This might be silly but just making sure, this only works if you installed the crate right?

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

If you installed the executable, yes. I guess I hope that's not too much to assume…

@sampsyo sampsyo merged commit a8c6310 into main Jul 24, 2025
18 checks passed
@sampsyo sampsyo deleted the fud2-docs-rec branch July 24, 2025 15:40
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

3 participants