elm-lang / elm-package

Command line tool to share Elm libraries

Geek Repo:Geek Repo

Github PK Tool:Github PK Tool

Feature: elm package docs a-package

mgold opened this issue · comments

This is meant to go in the batch of work for the "packaging story". It would be a useful feature if running elm package docs elm-test pulled up the package.elm-lang.org webpage with the docs for that package, based on the version and repo installed in elm-package.json.

Thanks for the issue! Make sure it satisfies this checklist. My human colleagues will appreciate it!

Here is what to expect next, and if anyone wants to comment, keep these things in mind.

This is related to elm-lang/elm-make#28

@evancz proposed a solution that I consider is the best way to go. elm-package would download documentation.json from the packages.elm-lang.org site and place them inside the module folder. Then some tool can read it and turn it into more useful data like Markdown, HTML or other documentation format.

I'm also working on an Elm page that allows you to open a documentation.json and render it like in packages.elm-lang.org which should work offline. This is a project from elm-lang/project (added at elm-lang/project@85babf645782864323bb)

In addition to this I have created a script in JavaScript that searches the elm-stuff folder and downloads documentation.json files for each of the installed modules. (I have yet to release this since it's WIP)

In the future I would like to create an application (probably Electron + Elm) that searches elm-stuff to find documentation.json files for each module (download them if not found), and also find/create documentation.json files for all private modules in the project and display them in a tidy neat way

commented

Check out elm-help, which allows you to do this sort of thing: https://www.npmjs.com/package/elm-help