JuliaDocs
Examples should be updated
We have examples here, but some of the links seem not good for beginner.
- The
stablelink is not deployed correctly (e.g. ControlSystems.jl) - The site is no longer generated by Documenter.jl (e.g. Bio.jl, MergedMethods.jl)
- That package doesn't seem to be actively being developed. (e.g. BanditOpt.jl)
- The site is not generated with latest Documenter.jl (e.g. EvolvingGraphs.jl)
- The package is not registered (e.g. NLOptControl.jl)
Should we remove these links? If so, I'll fix them in #1659.
Now that almost all packages use Documenter I feel like the list should either be removed or be curated to only include links to packages that does something extra (custom CSS, examples with Literate, etc).
Is there any good place to find example documentation? I thought JuliaHub would be a good place to find packages and documentations, but the most of documentations are deployed on juliahub, and there's no "Edit on GitHub" button.
Now that almost all packages use Documenter I feel like the list should either be removed or be curated to only include links to packages that does something extra (custom CSS, examples with Literate, etc).
I agree with this. We could perhaps point to one or two well-maintained packages that do a good job with the docs where people could go and check the basic setup (in addition to the links to packages that are doing something special).
That said, in the meanwhile, we can also just make sure that the links we have there are up to date.