# Welcome to the GLQL Experimental feedback Issue! The purpose of this feedback issue is to collect feedback from Experimental users of the GLQL. Our goals are to identify and prioritize bugs and issues, capture ideas for new features and improvements, and ultimately enhance user satisfaction and product quality. Your input is crucial in helping us understand and address the needs of our users, ensuring that our product continues to evolve and improve. ## What is GLQL? GitLab Query Language (GLQL) is an Experimental attempt to create a single query language for all of GitLab which allows for filtering and embedding content from anywhere in the product. Documentation for general usage of GLQL and its syntax can be found on [here](https://docs.gitlab.com/ee/user/glql/index.html). ## How to give feedback Feedback of any kind is welcome. You may have questions, concerns or suggestions about syntax, applications of the language, implementation (security, performance, maintainability), or anything in between. * **Check existing feedback & known issues:** Before submitting, check to see if your feedback is already captured or reported by someone else in this issue. If so, comment on the existing thread or leave an emoji reaction to show support. * **Start a new thread:** If your feedback is not listed, start a new thread with a descriptive title. Include relevant details, screenshots, and steps to reproduce the issue in expandable sections. * **Be Specific:** Provide as much detail as possible, including device/browser information, steps to reproduce, and expected vs. actual outcomes. ## What you can expect from us 1. We **will read** all of your feedback. 2. We **may not respond** to all feedback directly. 3. We will **create issues** for repeatable bugs and assign a [priority](https://handbook.gitlab.com/handbook/security/security-operations/sirt/severity-matrix/#priority) based on [severity](https://handbook.gitlab.com/handbook/security/security-operations/sirt/severity-matrix/#severity). ### Existing issues ```glql --- display: table fields: title, epic, labels("type::*"), labels("Knowledge::P*") --- group = "gitlab-org" and label = "glql" and label = "User Feedback" and opened = true ``` <details> <summary>Already addressed issues</summary> ```glql --- display: table fields: title, epic, labels("type::*") --- group = "gitlab-org" and label = "glql" and label = "User Feedback" and opened = false ``` </details> ## Find out more ### Documentation Documentation for general usage of GLQL and its syntax can be found [here](https://docs.gitlab.com/ee/user/glql/index.html). ### Demo video  ### Live example Display a table of first 5 open issues assigned to @himkp in `gitlab-org/gitlab`. Display columns "title", "state", "healthStatus", "description", "epic", "milestone" and "weight" and "updatedAt". ````markdown ```glql --- display: table fields: title, state, healthStatus, epic, milestone, weight, updatedAt limit: 5 --- project = "gitlab-org/gitlab" AND assignee = "himkp" AND opened = true ``` ```` The above query renders as a table as shown below: ```glql --- display: table fields: title, state, healthStatus, epic, milestone, weight, updatedAt limit: 5 --- project = "gitlab-org/gitlab" AND assignee = "himkp" AND opened = true ``` ### Other example use-cases * GLQL is used by ~"group::knowledge"'s EM @vshushlin to automatically generate a [weekly report of ongoing deliverables for the current milestone](https://gitlab.com/gitlab-org/plan-stage/plan-engineering/-/issues/1144#note_2077044636). This saves up a lot of effort in having to manually curate this list. ### Who can I contact directly for more information? Please consider leaving feedback publicly on this issue. However, if you need to you can contact, you can reach out on Slack: * Feature channel: [`#f_glql`](https://gitlab.enterprise.slack.com/archives/C07HUEF4VPD) * Group channel: [`#g_knowledge`](https://gitlab.enterprise.slack.com/archives/C04R571QF5E) * Compiler / Backend: @johnhope * Frontend: @himkp @ntepluhina * PM: @mmacfarlane * UX: @afracazo * EM: @vshushlin ## About the compiler <details> <summary>How can I try it out?</summary> The project is currently located at https://gitlab.com/gitlab-org/gitlab-query-language/gitlab-query-language. Contributions are welcome! You can download a build of the compiler and REPL for your system from the [artifacts](https://gitlab.com/johnhope/gitlab-query-language/-/artifacts) page of the project. Look for the latest `build-osx` or `build-linux` job and download and extract the tarball. Then ensure `glql` and `glqli` are in your $PATH. * `glqli` is a REPL that will allow you to run arbitrary queries from your terminal. You can pass command line attributes as `:` prefixed words. For example; to change the target from GraphQL (default) to URL Params do `:target url_params`. You can also download the latest WASM module build from the same artifacts page. </details>