Skip to content

fix(fluxdoc): use db when generating docs #5322

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 1 commit into from
Nov 1, 2022
Merged

Conversation

nathanielc
Copy link
Contributor

Previously the fluxdoc gen would run a compilation step using fluxc to speed up compilation. Compilation is very fast now and we have the salsa db that does proper caching of intermediate steps. This change removes the fluxc binary and the left over unused code. Also we update the fluxdoc binary to use the salsa db only.

Since this is potentially a perf change I tested how fast the docs generate, its dominated almost exclusively in running the examples. Compiling the stdlib is instantaneous in my system.

Checklist

Dear Author 👋, the following checks should be completed (or explicitly dismissed) before merging.

  • ✏️ Write a PR description, regardless of triviality, to include the value of this PR
  • 🔗 Reference related issues
  • 🏃 Test cases are included to exercise the new code
  • 🧪 If new packages are being introduced to stdlib, link to Working Group discussion notes and ensure it lands under experimental/
  • 📖 If language features are changing, ensure docs/Spec.md has been updated

Dear Reviewer(s) 👋, you are responsible (among others) for ensuring the completeness and quality of the above before approval.

Siteproxy
@nathanielc nathanielc requested a review from wolffcm October 31, 2022 21:51
@nathanielc nathanielc requested a review from a team as a code owner October 31, 2022 21:51
@nathanielc nathanielc force-pushed the fix/fluxdocs-salsa-db branch 2 times, most recently from d099de5 to f3ac1f7 Compare October 31, 2022 22:23
Previously the fluxdoc gen would run a compilation step using `fluxc` to
speed up compilation. Compilation is very fast now and we have the salsa
db that does proper caching of intermediate steps. This change removes
the `fluxc` binary and the left over unused code. Also we update the
`fluxdoc` binary to use the salsa db only.

Since this is potentially a perf change I tested how fast the docs
generate, its dominated almost exclusively in running the examples.
Compiling the stdlib is instantaneous in my system.
@nathanielc nathanielc force-pushed the fix/fluxdocs-salsa-db branch from f3ac1f7 to bed4547 Compare October 31, 2022 22:28
Copy link

@wolffcm wolffcm left a comment

Choose a reason for hiding this comment

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

Looks good! Glad to see that Salsa already is paying off.

@nathanielc nathanielc merged commit bf75c1b into master Nov 1, 2022
@nathanielc nathanielc deleted the fix/fluxdocs-salsa-db branch November 1, 2022 14:29
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.

None yet

2 participants