Morten Piibeleht
Morten Piibeleht
Third action item here: 3. Add a `checkdocs = :public` option, to make sure that all docstrings that are considered public API are included in the manual. Current options are...
> It seems the generated reference file contains commit SHA's of the HEAD commit or so?! These look like source links? They would either point to a branch or the...
We actually used to do that, and I think it should doable with the new search as well, where we just look at and update a special query parameter. >...
Pre-1.0 that used to be possible: https://documenter.juliadocs.org/v0.27/search/?q=deploydocs I'd say we can bring this back if someone wants to take a stab at implementing it / recovering the original implementation. The...
I agree that it makes sense that the global setup should only apply once on named doctests. But my concern is that changing the behavior would be a breaking change....
I still think there's a strong case for not supporting them in the docstrings (the `help>` argument). But I think we can do the two actionable things here that you...
Two thoughts here: 1. So we do this thing where we `show` every available MIME type. I'm a little concerned that we might end up unintentionally rendering heaps of videos...
> For 1. I think it only becomes a problem if an object support all of the video formats and all three are rendered but perhaps this is common? Or...
> But are there objects which have both a video representation and image representations? I wouldn't be surprised if animations would fall back to the first frame maybe? But whether...
> > As a side note, some people complain about slow build times because of the display_dict so perhaps the mimes should somehow be filtered keeping in mind that not...