Skip to content

Overhaul web dev docs#248

Merged
JammingBen merged 2 commits intomainfrom
docs/overhaul-web-dev-docs
Apr 17, 2025
Merged

Overhaul web dev docs#248
JammingBen merged 2 commits intomainfrom
docs/overhaul-web-dev-docs

Conversation

@JammingBen
Copy link
Copy Markdown
Member

Gives the Web dev docs a much needed overhaul, fixes dead links and formats all md files in a consistent way.

Gives the Web dev docs a much needed overhaul, fixes dead links and formats all md files in a consistent way.
@JammingBen JammingBen self-assigned this Apr 16, 2025
Copilot AI review requested due to automatic review settings April 16, 2025 13:00
Copy link
Copy Markdown
Contributor

Copilot AI left a comment

Choose a reason for hiding this comment

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

Pull Request Overview

Overhauling the Web development docs with improved consistency in markdown formatting and updated links, instructions, and configuration examples. Key changes include:

  • Revised testing, installation, and configuration documentation to improve clarity.
  • Updated extension system docs to replace outdated “scopes” with “extensionPointIds” and to align icon source references.
  • Reorganized sections (e.g. tooling and repo structure) for improved readability and usability.

Reviewed Changes

Copilot reviewed 16 out of 16 changed files in this pull request and generated no comments.

Show a summary per file
File Description
docs/dev/web/testing/running-tests.md Updated introduction and test instructions with clearer assumptions.
docs/dev/web/testing/e2e-testing-standards.md Removed extraneous examples and updated a code sample to use consistent syntax.
docs/dev/web/getting-started.md Reorganized installation and configuration sections with updated links.
docs/dev/web/extension-system/*.md Standardized usage of extensionPointIds, updated import formatting, and revised icon source comments.
docs/dev/web/embed-mode.md Reformatted the iframe example for improved markdown clarity.
docs/dev/web/development/tooling.md Enhanced instructions with updated commands and setup notes for instant hot-reloading.
docs/dev/web/development/repo-structure.md Refined descriptions of repo components and package details.
docs/dev/web/development/conventions.md Updated conventions with a focus on modern TypeScript and Composition API usage.
Comments suppressed due to low confidence (3)

docs/dev/web/extension-system/index.md:67

  • Ensure that the change from the previous icon source URL to Remix Icon is consistently applied across all extension docs for clarity.
icon: 'aliens', // See https://remixicon.com/ for available options

docs/dev/web/development/tooling.md:43

  • [nitpick] Confirm that running the OpenCloud server in detached mode (-d) aligns with your development workflow requirements.
$ docker-compose up opencloud -d

docs/dev/web/extension-system/extension-types/left-sidebar-menu-item-extensions.md:49

  • Verify that replacing 'scopes' with 'extensionPointIds' in this extension configuration is consistent with the expected configuration across your extension system.
extensionPointIds: ['app.files.navItems'],

@JammingBen JammingBen requested a review from AlexAndBear April 16, 2025 13:06
Comment thread docs/dev/web/development/repo-structure.md Outdated
Comment thread docs/dev/web/extension-system/index.md Outdated
Co-authored-by: Phil Davis <phil@jankaritech.com>
Copy link
Copy Markdown
Member

@AlexAndBear AlexAndBear left a comment

Choose a reason for hiding this comment

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

lgtm

@JammingBen JammingBen merged commit 088ee8a into main Apr 17, 2025
1 check passed
@JammingBen JammingBen deleted the docs/overhaul-web-dev-docs branch April 17, 2025 07:52
@openclouders openclouders mentioned this pull request Apr 16, 2025
1 task
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

4 participants