odin-lang / pkg.odin-lang.org Goto Github PK

I keep "loosing" doc tabs of https://pkg.odin-lang.org, because they do not "stand out" in browser's tab list — they have no favicon.

I trained myself to look for "package" title:

Would be nice to have a favicon there.

I could do a PR, but which icon to put there? Official odin logo? (which you can see on the screenshot above where https://odin-lang.org is opened) Or is there more suitable icon maybe?

Looks like the parser doesn't escape HTML tags or something. So this:

read :: proc(data: []byte, filename := "<input>", print_error := false, allocator := context.allocator) -> (file: File, err: Read_Error) {}

becomes this:

The builtin package is appearing on the vendor page in the website:

And when pressed it takes us to a 404 page:

Documentation for darwin packages, for example Metal are not generated.
https://pkg.odin-lang.org/vendor/darwin/Metal/
I tried generating the documentation on MacOS

it seems that
odin doc examples/all -all-packages -doc-format -show-debug-messages
generates the packages

[DEBUG] odin_doc_add_pkg_entries writing -> package darwin
...
[DEBUG] odin_doc_add_pkg_entries writing -> package objc_Foundation
[DEBUG] odin_doc_add_pkg_entries writing -> package objc_Metal
[DEBUG] odin_doc_add_pkg_entries writing -> package objc_MetalKit
[DEBUG] odin_doc_add_pkg_entries writing -> package objc_QuartzCore

However directx packages are not generated, neither x11 package
Considering that the github actions are run on windows, and directX packages are on the documentation page
odin doc only generates the packages for the host OS