Gradualizer icon indicating copy to clipboard operation
Gradualizer copied to clipboard

Use ExDoc

Open erszcz opened this issue 2 years ago • 2 comments

Screenshot 2022-09-14 at 22 04 22 Screenshot 2022-09-14 at 22 04 16

The docs aren't hosted online anywhere, but it would be quite easy to host them on GH Pages or https://hexdocs.pm.

erszcz avatar Sep 14 '22 20:09 erszcz

Feel free to upload it to hexdocs if you want. Do you want to publish gradualizer on hex as well?

zuiderkwast avatar Sep 15 '22 08:09 zuiderkwast

I didn't know you can use ExDoc for plain Erlang projects.

Yeah, it was a journey, but it's possible for some time now, thanks to our work in the EEF Docs and then Build and Packaging working groups. I borrowed some doc handling/storage ideas from Elixir for docsh, then based on that we (Jose Valim, I, and Eric Bailey) sketched EEP-48, Lukas Larsson added doc chunk support and shell_docs to OTP 23.0, I added doc chunk support to EDoc for OTP 24.0, Jose and Wojtek Mach did their part in ExDoc to handle both languages, and Bryan Paxton packaged that as rebar3_ex_doc. That's how we got it :)

Feel free to upload it to hexdocs if you want. Do you want to publish gradualizer on hex as well?

I think there's already a package available on Hex, but a bit outdated with regard to the current master. There have been no versions tagged for a while. No docs on hexdocs, though. I think I can upload these at some point in the next few days, but I might need the permissions for the existing package on Hex - @zuiderkwast could you add me (https://hex.pm/users/erszcz) there?

erszcz avatar Sep 15 '22 11:09 erszcz

:+1: I added you as an owner of the Hex package now.

zuiderkwast avatar Sep 19 '22 07:09 zuiderkwast

Any comments on this one? I'm thinking of tagging a release after merging it - there hasn't been one for a looong time. WDYT?

erszcz avatar Nov 18 '22 18:11 erszcz

Sounds good.

I see there are some other stuff in this PR such as README changes.

@josefs please check if you agree with the changes to README.md

zuiderkwast avatar Nov 18 '22 20:11 zuiderkwast