mirror of
https://github.com/googleapis/genai-toolbox.git
synced 2026-01-10 07:58:12 -05:00
updated:developer.md
This commit is contained in:
@@ -226,8 +226,10 @@ We use **[lychee](https://github.com/lycheeverse/lychee-action)** for repository
|
||||
# These are email addresses, not standard web URLs, and usually cause check failures.
|
||||
^mailto:.*
|
||||
```
|
||||
|
||||
> **Note:** Local links and directory changes work differently on GitHub than on the docsite, you must ensure fixes pass the **GitHub check** and also work with **`hugo server`**.
|
||||
> [!NOTE]
|
||||
> **GitHub Action Check**: The link checker runs against the raw Markdown files in the repository structure, treating links as relative file paths (e.g., ../content/page.md).<br>
|
||||
> **Hugo Server**: The static site generator resolves links based on the final clean URL structure (e.g., /page/) and the configured baseURL.<br>
|
||||
> **Crucial Difference**: A link that works as a file path for the GitHub Action (e.g., ./image.png) may break in the final HTML generated by Hugo if the URL path is different, and vice-versa. You must ensure your linking strategy—often using root-relative paths (/path/) or Hugo Page Bundles—works seamlessly for both.
|
||||
### Other GitHub Checks
|
||||
|
||||
* License header check (`.github/header-checker-lint.yml`) - Ensures files have
|
||||
|
||||
Reference in New Issue
Block a user