amoghrajesh opened a new pull request, #77143:
URL: https://github.com/apache/airflow/pull/77143

    <!-- SPDX-License-Identifier: Apache-2.0
         https://www.apache.org/licenses/LICENSE-2.0 -->
   
   <!--
   Thank you for contributing!
   
   Please provide above a brief description of the changes made in this pull 
request.
   Write a good git commit message following this guide: 
https://chris.beams.io/posts/git-commit/
   
   Please make sure that your code changes are covered with tests.
   And in case of new features or big changes remember to adjust the 
documentation.
   
   For user-facing UI changes, please attach before/after screenshots (or a 
short
   screen recording) so reviewers can assess the visual impact.
   
   Feel free to ping (in general) for the review if you do not see reaction for 
a few days
   (72 Hours is the minimum reaction time you can expect from volunteers) - we 
sometimes miss notifications.
   
   In case of an existing issue, reference it using one of the following:
   
   * closes: #ISSUE
   * related: #ISSUE
   -->
   
   ---
   
   ##### Was generative AI tooling used to co-author this PR?
   
   <!--
   If generative AI tooling has been used in the process of authoring this PR, 
please
   change below checkbox to `[X]` followed by the name of the tool, uncomment 
the "Generated-by".
   -->
   
   - [x] Yes (please specify the tool below)
   
   <!--
   Generated-by: [Tool Name] following [the 
guidelines](https://github.com/apache/airflow/blob/main/contributing-docs/05_pull_requests.rst#gen-ai-assisted-contributions)
   -->
   
   
   
   ---
   
   
   ### What
   
   The registry nav has a "Durable Execution" item for a page that lists only 
durable and deferrable modules. People come to the registry looking for 
operators first. Durable support helps them choose between operators, but it 
doesn't need a page of its own.
   
   ### Current behaviour
   
   - The nav shows "Durable Execution", which goes to `/durable/`.
   - That page lists only durable or deferrable modules. There is no single 
page to browse every operator, hook, sensor or trigger across providers.
   
   ### Proposed change
   
   - The nav item is now **Operators** and goes to a new `/operators/` page 
that lists every module from every provider.
   - Durable and deferrable support is a filter on that page (All, Durable or 
deferrable, Durable, Deferrable), next to the existing Type, Provider and 
search filters.
   - The page opens with Type set to Operators. Hooks, sensors, triggers and 
the other types are one pick away in the Type filter, so they don't need 
separate menu items.
   - The capability button counts follow the other filters, so "Durable (9)" 
means 9 rows are shown.
   - Filter state lives in the URL, so a filtered view can be shared. Picking 
"All types" adds `type=all` to the URL.
   
   ### Changes of Note
   
   - The site is static, so every module is rendered into the page and 
filtering runs in the browser, as on the old page.
   - Partial provider waves need nothing new. The page is built from the merged 
`modules.json`, so providers outside the wave keep their modules.
   - The page reuses the old durable page's template, filter JS and styles. 
Most of the diff is the rename from `durable` to `operators`.
   
   ### User implications / backcompat
   
   - `/durable/` still works. It redirects to `/operators/` with the durable or 
deferrable filter on and all types shown, so it lists the same modules as 
before.
   - Old filtered links keep their filters. For example, 
`/durable/?provider=amazon` opens 
`/operators/?capability=durable-or-deferrable&provider=amazon&type=all`. 
Without JavaScript, the redirect falls back to the durable or deferrable view 
without the extra filters.
   - The sitemap now lists `/operators/` instead of `/durable/`.
   
   ### Testing
   
   - `pnpm build` passes.
   - Checked in a browser against a local build (generated data for 5 
providers):
     - default view
     - each capability filter, and that its button count matches the rows shown
     - type and provider filters
     - search and the "No modules found" message
     - the `/durable/` redirect, with and without old query strings, and with 
JavaScript off
     - filters restored from a shared URL
     - the link from the provider page
     - dark mode and the mobile menu
   - Every count matched a count taken straight from `modules.json`.
   
   Screenshots:
   
   
   <img width="1400" height="1000" alt="01-home-nav" 
src="https://github.com/user-attachments/assets/12dca7e5-a71a-4932-8232-d4754d7e2fa7";
 />
   <img width="1400" height="1000" alt="02-operators-default" 
src="https://github.com/user-attachments/assets/94c09cf7-9aba-4092-bcc1-e5232b141b32";
 />
   <img width="1400" height="1000" alt="02b-all-types" 
src="https://github.com/user-attachments/assets/57c6c608-7639-4081-8a4d-caca2e1e513f";
 />
   <img width="1400" height="1000" alt="03-filter-durable" 
src="https://github.com/user-attachments/assets/ca1f08be-0479-4dbb-831d-38cbc7bccaea";
 />
   <img width="1400" height="1000" alt="04-type-sensor" 
src="https://github.com/user-attachments/assets/dec1b71f-421b-425d-a57b-0cb4a5e236c6";
 />
   <img width="1400" height="1000" alt="05-amazon-hooks" 
src="https://github.com/user-attachments/assets/7704e6aa-606f-4d77-bc0c-69c873a68347";
 />
   <img width="1400" height="1000" alt="06-search-glue" 
src="https://github.com/user-attachments/assets/3eebc17d-c3ff-4c78-9395-6e23a681a690";
 />
   <img width="1400" height="1000" alt="07-empty-state" 
src="https://github.com/user-attachments/assets/f3ade5ac-4a4e-4248-b4b2-42158fb92b94";
 />
   <img width="1400" height="1000" alt="08-durable-redirect" 
src="https://github.com/user-attachments/assets/79545585-d8a3-4297-a143-70ceb673519d";
 />
   <img width="1400" height="1000" alt="09-shared-url" 
src="https://github.com/user-attachments/assets/76b79b2f-1c8d-4317-a79c-7887d1e92c90";
 />
   
   
   <img width="1400" height="1000" alt="10-provider-link" 
src="https://github.com/user-attachments/assets/83e5fb0d-24fa-4432-9f67-825e20aa5730";
 />
   <img width="1400" height="1000" alt="11-dark-mode" 
src="https://github.com/user-attachments/assets/cb1851a9-d43e-4e88-b0a8-520228cc7454";
 />
   <img width="1400" height="1000" alt="11-light-mode" 
src="https://github.com/user-attachments/assets/5a87b828-debb-4218-bd3e-041657db8532";
 />
   <img width="390" height="844" alt="12-mobile" 
src="https://github.com/user-attachments/assets/bd8d51a4-f9a5-43e6-95d9-1f4f60540339";
 />
   <img width="390" height="844" alt="13-mobile-menu" 
src="https://github.com/user-attachments/assets/09ff2e61-6eb8-4a4f-9e55-d811ee1bf141";
 />
   <img width="1400" height="1000" alt="14-counts-follow-type" 
src="https://github.com/user-attachments/assets/cacf6f64-c466-4fe6-b6cd-95db850d17e7";
 />
   <img width="1400" height="1000" alt="15-counts-follow-provider-search" 
src="https://github.com/user-attachments/assets/2f7c2d99-8d3b-4626-b4ad-614b00f08144";
 />
   <img width="1400" height="1000" alt="16-old-link-keeps-filters" 
src="https://github.com/user-attachments/assets/93f05a82-5e66-4b10-b1fa-0e44a3eec3e5";
 />
   
   ---
   
   * Read the **[Pull Request 
Guidelines](https://github.com/apache/airflow/blob/main/contributing-docs/05_pull_requests.rst#pull-request-guidelines)**
 for more information. Note: commit author/co-author name and email in commits 
become permanently public when merged.
   * For fundamental code changes, an Airflow Improvement Proposal 
([AIP](https://cwiki.apache.org/confluence/display/AIRFLOW/Airflow+Improvement+Proposals))
 is needed.
   * When adding dependency, check compliance with the [ASF 3rd Party License 
Policy](https://www.apache.org/legal/resolved.html#category-x).
   * For significant user-facing changes create newsfragment: 
`{pr_number}.significant.rst`, in 
[airflow-core/newsfragments](https://github.com/apache/airflow/tree/main/airflow-core/newsfragments).
 You can add this file in a follow-up commit after the PR is created so you 
know the PR number.
   


-- 
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.

To unsubscribe, e-mail: [email protected]

For queries about this service, please contact Infrastructure at:
[email protected]

Reply via email to