Skip to content

docs: rewrite README as Qt/QML VS Code config demo (+ qmlls settings)#7

Merged
deku2026 merged 2 commits into
mainfrom
feat/vscode-qmlls-and-readme
May 30, 2026
Merged

docs: rewrite README as Qt/QML VS Code config demo (+ qmlls settings)#7
deku2026 merged 2 commits into
mainfrom
feat/vscode-qmlls-and-readme

Conversation

@deku2026
Copy link
Copy Markdown
Contributor

What

This PR brings two things onto main:

  1. The new main diffAdd QML Language Server settings to VSCode configuration (1daa218), which was on local main but not yet on the remote. It adds the qmlls (QML Language Server) configuration to .vscode/settings.json.
  2. A full README rewrite — the old README.md was a leftover copy of the upstream Notes app and didn't describe this repository at all.

README rewrite

The new README.md introduces this repo as a Qt / QML VS Code configuration demo and documents .vscode/settings.json key by key:

  • C++ via clangdC_Cpp.intelliSenseEngine: disabled to hand IntelliSense to clangd, plus the clangd formatter setup.
  • CMake Presetscmake.useCMakePresets: always.
  • Editor / formatting — font, ligatures, 2-space indent, rulers, format-on-save.
  • File behavior.h/.hpp/.inl → C++ associations, trim trailing whitespace, final newline.
  • Search excludesbuild, .cache, node_modules, *_autogen.
  • ⭐ QML Language Server (qmlls) — every qt-qml.qmlls.* key explained (customExePath, additionalImportPaths, customArgs -b/-d, useNoCMakeCalls, tracing), and how they mirror the build-generated .qmlls.ini produced by cmake/sync_qmlls_ini.cmake.

It also documents extensions.json, launch.json, and tasks.json, plus a quick-start and FAQ.

Notes

  • No source or config behavior changes beyond the already-committed settings.json qmlls additions — the rewrite touches documentation only.
  • Absolute Qt paths in settings.json are called out in the README as machine-specific and meant to be adjusted by the reader.

🤖 Generated with Claude Code

deku2026 and others added 2 commits May 30, 2026 03:31
Replace the leftover upstream Notes README with documentation for this
repository as a VS Code configuration demo for Qt6 + QML development.

The new README focuses on .vscode/settings.json, explaining every key
group by group: disabling the MS C/C++ IntelliSense engine in favor of
clangd, CMake Presets, editor/formatting options, file associations,
search excludes, and especially the QML Language Server (qmlls) settings
and how they relate to the build-generated .qmlls.ini. It also documents
extensions.json, launch.json and tasks.json.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
@deku2026 deku2026 merged commit d955c2d into main May 30, 2026
2 checks passed
@deku2026 deku2026 deleted the feat/vscode-qmlls-and-readme branch May 30, 2026 11:25
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.

1 participant