ImageFiltering.jl icon indicating copy to clipboard operation
ImageFiltering.jl copied to clipboard

Reorganize the documentation

Open timholy opened this issue 5 years ago • 4 comments

This package has some lovely, but long, documentation strings. Starting with Julia 1.5, the REPL will let you choose between brief and extended help. The documentation of this package should be reorganized to take advantage of that structure. PR #151 illustrates what this process might look like.

timholy avatar Jan 27 '20 09:01 timholy

I've proposed a documentation guide months ago based on the style used by @zygmuntszpak when I was new to Julia https://github.com/JuliaImages/Images.jl/issues/790 Perhaps it's the time to review it?

johnnychen94 avatar Jan 27 '20 10:01 johnnychen94

Hello, I was wondering if there is way of viewing the documentation for this package in a HTML version. (Perhaps something exported with Documenter.jl that can be added to the Images.jl package documentation? Or is there a way to generate the docs for this package localy? - here I don't know how I would go about it though.) I would be fantastic to have some webpage where I can read the docstrings of functions from this package with functional Latex. The Latex parts of the docstrings in Juno aren't human-readable.

I apologise if this isn't the right place to request it or ask for help, I think of a better way.

Kunz-David avatar Mar 06 '20 10:03 Kunz-David

https://juliaimages.org/stable/, specifically https://juliaimages.org/stable/imagefiltering/ and the API reference in https://juliaimages.org/stable/function_reference/#Image-algorithms-1.

EDIT: if you forget where it is, when searching it's the top hit for "JuliaImages"

timholy avatar Mar 06 '20 11:03 timholy

https://juliaimages.org/stable/, specifically https://juliaimages.org/stable/imagefiltering/ and the API reference in https://juliaimages.org/stable/function_reference/#Image-algorithms-1.

EDIT: if you forget where it is, when searching it's the top hit for "JuliaImages"

Thanks for the help. I was looking for the API. Turns out I was just blind :(

Kunz-David avatar Mar 06 '20 13:03 Kunz-David