Skip to content

Component documentation in Markdown 2/2 #13203

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

Open
wants to merge 15 commits into
base: develop
Choose a base branch
from

Conversation

vitvakatu
Copy link
Contributor

@vitvakatu vitvakatu commented May 29, 2025

Pull Request Description

Second part of #12983

This removes the doc parser, addresses the remaining review comments from the first PR, and fixes some minor issues in documentation breadcrumbs.

This one should be merged after migration to the markdown in the stdlib docs.

markdown-docs-part-2.mp4

Important Notes

Integration tests are failing because we need to regenerate the mock suggestions file. It will be easier when the docs in the stdlib are updated to the new format.

Checklist

Please ensure that the following checklist has been satisfied before submitting the PR:

  • The documentation has been updated, if necessary.
  • Screenshots/screencasts have been attached, if there are any visual changes. For interactive or animated visual changes, a screencast is preferred.
  • All code follows the
    Scala,
    Java,
    TypeScript,
    and
    Rust
    style guides. In case you are using a language not listed above, follow the Rust style guide.
  • Unit tests have been written where possible.
  • If meaningful changes were made to logic or tests affecting Enso Cloud integration in the libraries,
    or the Snowflake database integration, a run of the Extra Tests has been scheduled.
    • If applicable, it is suggested to paste a link to a successful run of the Extra Tests.

@vitvakatu vitvakatu self-assigned this May 29, 2025
@vitvakatu vitvakatu added the -gui label May 29, 2025
Copy link

github-actions bot commented May 29, 2025

✨ GUI Checks Results

Summary

  • 🧹 Prettier: ✅ Passed
  • 🧰 GUI Checks: ❌ Failed
  • 📚 Storybook: ✅ Deployed

⚠️ Action Required: Please review the failed checks and fix them before merging.

See individual check results for more details.

ℹ️ Chromatic Tests Skipped

Chromatic visual regression tests were skipped for this PR.

To run the tests and deploy Storybook, add the CI: Run Chromatic label to this PR.

Note: We skip tests by default to optimize CI costs. Only run them when your UI changes are ready for review.

👮 Lint GUI Results

Check Results

  • 🧠 Typecheck: ✅ Passed
  • 🧹 Lint: ✅ Passed
  • 🧪 Unit Tests: ✅ Passed

🎭 Playwright Test Results

Summary

  • ⏳ Duration: 6m 20s
  • ✅ Passed: 340 tests
  • 🔴 Failed: 9 tests
  • ⚠️ Flaky: 0 tests

📥 Download Detailed Report

⚠️ Action Required: Please review the failed tests and fix them before merging.

Copy link

🔄 GUI Checks in Progress

The following checks are being performed:

  • 🧹 Code formatting with Prettier
  • 👮 Linting and type checking
  • 🧪 Unit tests
  • 🎭 Integration tests with Playwright
  • 📚 Storybook deployment

Results will be updated here once completed.

@@ -38,7 +38,7 @@ export class SuggestionDb extends ReactiveDb<SuggestionId, SuggestionEntry> {
[entry.definitionPath.key(), id],
])
readonly childIdToParentId = new ReactiveIndex(this, (id, entry) => {
const parentAndChild = entry.definitionPath.splitAtName()
const parentAndChild = entry.definitionPath.normalized().splitAtName()
Copy link
Contributor Author

Choose a reason for hiding this comment

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

I think this one is correct, because it allows Standard.Base.Main.Something to be recognized as Standard.Base parent and Something child. Also see modification in projectPaths.

Comment on lines -110 to +112
const projectKey = this.project ?? '$'
return this.path ? `${projectKey}.${this.path}` : projectKey
const normalized = this.normalized()
const projectKey = normalized.project ?? '$'
return normalized.path ? `${projectKey}.${normalized.path}` : projectKey
Copy link
Contributor Author

Choose a reason for hiding this comment

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

This one is errr... questionable, but I find it fixed issues with Standard.Base.Main being referred as Standard.Base.Main in suggestion db while as Standard.Base everywhere else. @kazcw do you think this is a correct modification? I lose track of where we normalize Main and where we don’t.

Copy link
Contributor

Choose a reason for hiding this comment

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

I think that's good: we should use normalized names everywhere except when sending paths to LS.

@vitvakatu vitvakatu marked this pull request as ready for review May 30, 2025 10:32
Copy link
Contributor

@farmaazon farmaazon left a comment

Choose a reason for hiding this comment

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

I assume removed tests are now either logic of 3rd parties or covered elsewhere.

Comment on lines -110 to +112
const projectKey = this.project ?? '$'
return this.path ? `${projectKey}.${this.path}` : projectKey
const normalized = this.normalized()
const projectKey = normalized.project ?? '$'
return normalized.path ? `${projectKey}.${normalized.path}` : projectKey
Copy link
Contributor

Choose a reason for hiding this comment

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

I think that's good: we should use normalized names everywhere except when sending paths to LS.

@vitvakatu vitvakatu linked an issue Jun 9, 2025 that may be closed by this pull request
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
Projects
None yet
Development

Successfully merging this pull request may close these issues.

Move component level documentation to markdown
2 participants