Skip to content

Conversation

Copy link
Contributor

Copilot AI commented Dec 30, 2025

Complete TQL Documentation Implementation

Progress:

  • Analyze existing TQL infrastructure and documentation
  • Expand TqlTutorialViewModel with comprehensive lessons including:
    • All basic filtering operations (4 lessons)
    • All operators (7 lessons: >, <, >=, ranges, ^, $, ~)
    • All logical combiners (8 lessons: AND, OR, NOT, grouping)
    • All sorting and limiting options (6 lessons)
    • All commands (3 lessons: play, save, addnext)
    • Natural language processing examples (8 lessons)
    • Advanced field queries (5 lessons: rating, plays, skips, ranks, etc.)
    • Boolean fields (4 lessons: favorites, lyrics)
    • Numeric fields (8 lessons: rating, plays, skips, BPM, bitrate, etc.)
    • Duration queries (3 lessons)
    • Date/time queries (3 lessons)
    • Advanced features (5 lessons: lyrics search, notes, format, composer)
    • Real-world examples (6 lessons: workout, focus, nostalgia, hidden gems, etc.)
  • Update TqlDocumentation.cs with 60+ matching examples
  • Add warning/guidance when user has no songs
  • Test UI to ensure queries are clickable and execute properly
  • Add comprehensive README or markdown documentation

Summary:

  • Added 100+ comprehensive TQL lessons across 11 categories
  • Added 60+ documentation items with updated categories
  • Added warning card in Android TQL guide when no songs exist
  • Implemented HasSongs() check in BaseViewModelAnd for validation
  • All examples are clickable and will execute in the UI
Original prompt

This section details on the original issue you should resolve

<issue_title>Complete documentation on TQL</issue_title>
<issue_description>A complete documentation and orientation on how user can use TQL would be good.
But my thought on it is that each explained step should have an applicable tql query that user can click to see live in UI.

If user has no song then they can't see TQL tutorials.

Everything should be detailed including the Natural language processing ones like "my fav", "songs by {artist}" </issue_description>

Comments on the Issue (you are @copilot in this section)


✨ Let Copilot coding agent set things up for you — coding agent works faster and does higher quality work when set up for your repo.

Copilot AI and others added 2 commits December 30, 2025 12:53
Co-authored-by: YBTopaz8 <41630728+YBTopaz8@users.noreply.github.com>
Co-authored-by: YBTopaz8 <41630728+YBTopaz8@users.noreply.github.com>
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.

Complete documentation on TQL

2 participants