Abhirath Anand

Results 68 comments of Abhirath Anand
trafficstars

This is amazing, thanks @Saransh-cpp! The current docs look good (and will be filled up considerably after this migration). Just one question, is there a way to perhaps migrate the...

> Are we sure this is a good idea? Among other things, the entirety of https://fluxml.ai/Metalhead.jl/dev/docstrings.html has disappeared. Having a good API reference was part of the reason we ditched...

> To be clear, I don't just mean the content is missing, but that the reference page itself is as well. Documenter has extraordinarily poor support for listing and searching...

> 1. Some way to make CI complain on dangling docstrings/undocumented functions This already happens silently like [so](https://github.com/FluxML/Metalhead.jl/runs/7807657734?check_suite_focus=true#step:6:92). I might have to look at the Documenter docs more closely to...

Side note: the [Lux docs](https://lux.csail.mit.edu/dev/) look beautiful IMO, and the theme really adds to the polish of the documentation - not to mention that its search is more powerful, so...

> If we are going to go through the hassle of using a static site generator for the docs, then why not use Franklin.jl? I was very interested in using...

In case we _are_ looking at other options, though, I also remembered that [Quarto](https://quarto.org/) has Julia support. A potential left field option could be tying it up with Documenter (it...

Wait this is weird but I just noticed https://saransh-cpp.github.io/Metalhead.jl/dev/api/models/ doesn't render the paper references accurately. Is this another Documenter thing? Edit: nevermind, brainfade - turns out we're using the wrong...

Also once this is in I think the Publish docs will stop deploying, so there probably needs to be a note somewhere to figure out how to navigate to older...

`Metalhead.resnet` is the biggest docstring of the lot 😅 Writing it might take a day or two. I'll get it to it though