Suggestions for 'Tutorial: Qt Widgets application'

Some suggestions for https://doc-snapshots.qt.io/vscodeext-dev/vscodeext-tutorials-qt-widgets.html:

Before you start

Remove 'Create a Qt Widgets application project' link, as it is literally the next section.

Linkify 'Qt Widgets Designer'.

Create a Qt Widgets application project

Project files are generated in an AddressBook folder in the current directory with default settings.

Consider replacing "current directory" with "default path and settings". This matches at least the preset files.dialog.defaultPath.

For this tutorial, rename widget.cpp, widget.h, and widget.ui to addressbook.cpp, addressbook.h, and addressbook.ui. Then, change the default class name Widget to AddressBook everywhere.

This is rather unprecise. How can one do this without messing up the CMakeLists.txt / #include's in the sources, effectively breaking the compilation? How can one rename the class without lots of manual fixing? etc

Design the main window

mainwindow.ui is actually not the "main window" in technical terms (QMainWindow), which includes menus. Qt Widgets Designer can also be used to design this. But addressbook.ui from the wizard is only a QWidget. So calling it 'main window' is misleading.

2. In the New Form dialog, select Close.

There should be no 'New Form'dialog opening if you launch Qt Widgets Designer in the advertised way.

In the Property Editor, set the ObjectName property to addressList.

it's 'objectName' (lower case)

Set the button names to addButton and deleteButton and text property values to Add and Delete.

Clearer would be IMO 'set the respective objectName property to addButton, deleteButton'

Rename the second label to emailLabel and leave its text property empty.

In the screenshot, the text property is actually "Email"