Skip to content
This repository has been archived by the owner on Aug 23, 2018. It is now read-only.

Feature: elm package docs a-package #240

Open
mgold opened this issue Sep 20, 2016 · 3 comments
Open

Feature: elm package docs a-package #240

mgold opened this issue Sep 20, 2016 · 3 comments
Labels

Comments

@mgold
Copy link

mgold commented Sep 20, 2016

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.

@process-bot
Copy link

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.

@pablomayobre
Copy link

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

@evancz evancz added the request label Jul 10, 2017
@eeue56
Copy link
Contributor

eeue56 commented Jan 28, 2018

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

Sign up for free to subscribe to this conversation on GitHub. Already have an account? Sign in.
Labels
Projects
None yet
Development

No branches or pull requests

5 participants