sshiv012 opened a new pull request, #8773:
URL: https://github.com/apache/texera/pull/8773
### What changes were proposed in this PR?
User docs rewritten for people who aren't programmers, with screenshots of
the current UI.
- **Rewritten:**
- the Python UDF guide: a first example, the 5 rules, and a
troubleshooting table mapping each error message to its fix;
- the "how to use Texera" guide: colors, where results and errors show,
and a stuck-workflow checklist;
- the dataset tutorial. The old one pointed to an `environment` tab that
no longer exists, and its sample CSV link returned 404. The CSV now ships with
the page.
- **New pages:** Computing Units, Sharing and Permissions, and How Texera
Runs Your Workflow (blocking operators, regions).
- **Links:** the Python UDF reference pages now link to the guide, and dead
links in Examples and Concepts are gone.
- **Warehouses:** runs can now need a warehouse (#8713), so the guide says
where to pick or create one.
- **Retaken images:** the two UDF error screenshots were retaken on a Texera
built with the code PRs, so they show the new messages.
- **Layout:** pages with images became folders (`page/index.md` with the
images next to it). The URLs stay the same.
The UDF guide quotes the new template and messages from the PRs below, so
this should merge after them. It stays a draft until they do.
### Any related issues, documentation, discussions?
Closes #8736. Depends on #8768, #8769, #8770, #8771, #8772. Replaces #8737.
### How was this PR tested?
A separate reviewer followed every tutorial in a local Texera as a
first-time user. The dataset tutorial reproduced the screenshot numbers (100 →
23 → 6). The steps they tripped on are fixed.
### Was this PR authored or co-authored using generative AI tooling?
Generated-by: Claude Code (Claude Opus 5.5)
--
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]
