The editor saves images under public/uploads/; articles reference them as /uploads/filename. One is a project location, the other a browser URL. Including public in the article URL adds a directory the site does not serve.
Local files keep writing and images portable, but size still needs attention. Astro copies public/ assets unchanged. This upload path does not automatically apply image-component compression, format conversion, or responsive sizes. Crop screenshots to useful content and offer a separate original when needed.
Descriptions should explain what matters in context. “Project screenshot” says little. “Articles grouped by year on the left, with the active tag filter on the right” communicates something useful. Important conclusions from a complex chart should also appear in the text.
Decoration that adds no information can use empty alternative text. An image acting as a link or button should describe its purpose. Before deleting an upload, check for references from other articles, especially when translations share an image.
References: Astro image locations, W3C’s alternative text decision tree.