Tier 1 Pages Research
Research compiled for Quick Start Guide, User Manual, and FAQ pages.
Official Documentation Resources Found
- Main Manual: https://qelectrotech.github.io/qelectrotech-doc/index.html
- YouTube Channel: https://www.youtube.com/user/scorpio8101/videos
- PDF Schemas: https://download.qelectrotech.org/qet/schemas_pdf
- Element Collection: https://download.qelectrotech.org/qet/elements/index.html
- Community Elements: https://download.qelectrotech.org/qet/elements_contrib/index.html
- Forum: qelectrotech.org/forum (850 EN topics, 1,124 FR topics)
Official Manual Structure
Main Topics Covered
- Basics — Launching (Linux, Windows, Mac), help, quitting
- Interface — Menus, toolbars, workspaces, panels, customization
- Preferences — Display, appearance, project/element/text/grid/export settings
- Projects — Create, open, save, properties, organization
- Folios — Types (single-line, multiline, control), properties, title blocks
- Elements — Types (simple, master, slave), properties, collections, editor
- Conductors — Single-line, multiline, appearance, numbering
- Schema Work — Add elements, draw conductors, text, shapes, select, copy/paste
- Reports — Summaries, nomenclature, conductor lists, I/O docs
- Export/Print — PDF, export, database exports
- Annex — Variables, fonts, colors
Common Beginner Question Areas (From Forum Analysis)
- Installation & Setup — Platform-specific (Windows, Linux, macOS)
- Element Creation & Management — Finding, using, creating elements
- Import/Export — DXF conversion, file format questions
- Drawing Basics — How to start, draw wires, add elements
- Documentation Gaps — Users need more getting-started materials
Example Projects Available
Industrial: CNC, PLC control, automation panels Residential: Home wiring, domotics, solar/PV systems Specialized: Vehicle wiring, HVAC, KNX automation, energy systems Educational: Basic circuits, training examples
Use these as reference examples for tutorials.
Key Insights
-
Beginner Struggle Areas:
- How to start a project
- Element placement and connection
- Drawing conductors/wires properly
- File import/export
-
Strong Community:
- 3,747+ users
- 850 EN help topics = active support
- Multilingual (FR, EN, DE, CS, etc.)
-
Good Visual Learning Resources:
- Existing PDF schemas/examples
- YouTube tutorials available
- Gallery of user projects
-
Documentation Opportunity:
- Wiki lacks beginner tutorials
- Quick Start and FAQ would fill gap
- Users currently ask in forums
For Quick Start Page
- Reference: Basics section (launching, interface, first project)
- Examples: Use simple circuit example
- Steps: New project → Add elements → Draw wire → Save
For User Manual Page
- Structure: Match official manual topics
- Add: Interface overview, feature screenshots
- Link: To official manual for deep dives
- Organize: By task type (not just features)
For FAQ Page
- Questions from forum patterns: installation, elements, import/export, drawing
- Answers: Based on official manual content
- Cover: Platform-specific (Windows/Linux/Mac) issues
Getting Started
🌐 Languages — English · Français · Deutsch
Guides
Conductors — wire properties, what feeds which export, and cables
Wire & cable catalogue — cable types, IEC 60757 core colours, assigning a core to a conductor
Printing and exporting — paper, PDF, images, and what each path does differently
Linking elements — master, slave, terminal
PLC modules — I/O tables and linking a wire to a specific point
Using the element editor — drawing tools, saving, checks
Preferences reference — what each settings page does
Keyboard-only control — mouseless QET, and the one real gap
Mouse modifiers — what Shift, Ctrl and Alt change while you drag
Managing collections — folders, writability, building your own shortlist
Templates — reusable multi-element blocks, and why clicking one does nothing
Search & Replace — bulk property changes
Building a nomenclature query — the BOM/summary table builder
Linking wires across pages — folio reports
Variables & formulas — %f, %{label}, sequences
Auto-numbering — schemes, sequences, freezing
Terminal strips — strips, levels, bridges
Title block templates — the .titleblock format
Importing EPLAN parts (.edz) — EPLAN Data Portal
DXF import & export — two unrelated features, one format
The project database — the in-memory SQLite cache
Development
Automating QET — CLI, XML formats, external tools
CLI Reference — command line usage
JavaScript Scripting — --run, geometry editing, undo
Vision — proposal, under discussion
