Comments (11)
I'm a bit reluctant to hijack debug.md
. Even if we do, let's minimize the precious vertical space make it a single paragraph.
I asked on the Slack maintainer channel how other people do this.
from elm.
We should absolutely add that somewhere. I'm not sure where though?
Maybe docs/INSTALLATION.md
(adding a section on how to install packages and explaining the situation here), or docs/TESTS.md
and add something about available packages on the test runner?
No perfect fit... @mpizenberg what do you think?
For CLI users, we should mention something in exercises/shared/.docs/tests.md
, which ends up in the locally downloaded HELP.md
. We should say that extra packages won't be ran on the online test-runner or analyzer.
Something else that might be nice would be to add all of the elm.json
as editor files (read-only). It wouldn't be very useful most of the time, but it would only be a click away in the editor.
@edgerunner would you like to help with some of that?
from elm.
I think those are all good ideas. In docs/INSTALLATION.md
we could add a small section about dependencies being installed in the elm.json
. There, we could explain that only a small subset of dependencies are usable by default for two reasons, (1) we do not want students to just download packages to solve problems, and (2) we need to pre-install that subset of packages on the exercism test runner for the elm track, which runs offline so it cannot download packages added by users.
In docs/TESTS.md
we could mention again point (2). And a message for CLI users in exercises/shared/.docs/tests.md
sounds good too!
Adding elm.json
to the read-only editor files for people using the online editor is also a good idea!
from elm.
It would be nice to see it in the instructions for the exercise as well, although that would require adding it to the .md file for every exercise, which would be a bit cumbersome, but maybe we can leverage configlet or something like that to automate it.
from elm.
I think the best spot could be the instructions. Is there a way to add another track-wide section similar to /exercises/shared/.docs/debug.md
?
OTOH, I think exposing a read-only elm.json
could turn out to be confusing for some users.
from elm.
As a short-term hack, what if we sneak that information into debug.md
?
Available libraries
The following libraries from the Elm package registry are installed by default. You can use them by importing their modules directly like so:
import Parser exposing (Parser, (|.), (|=), succeed)
Most exercises are designed to be completed by using the elm/core
library alone, but you may use these as well if you like. Other libraries from the Elm package registry are not available.
Debugging
…
from elm.
Trying to figure this out: Would it work if we added another file (a PACKAGES.md
maybe?) to config.json? Where would that show up?
from elm.
Hi Mert, there is a bit of chat about this on the exercism slack, I think it might be easier to have the conversation there.
https://exercism-team.slack.com/archives/GC3K95MRR/p1649725980776879
from elm.
Somewhat related. There is now a new key for the meta config.json
files of exercises which is called invalidator
. This is to mark files that mark a solution as outdated when changed.
Since we want the elm.json
changes to mark solutions as outdated, we should at least add the elm.json
to either the editor key or the invalidator key. And if we add it to the editor key, at least it is a solution to the question of which packages are available.
We can also do the rest of the ideas proposed here in complement. Waiting on answers in the slack discussion where Cedd just put a reminder message.
from elm.
@ceddlyburge the link doesn't seem to work. Can you ping me in that thread directly in slack?
from elm.
I think it was a private channel or something. I've mentioned you directly and invited you I think. Cheers, Cedd
from elm.
Related Issues (20)
- Concept: "Parse don't validate"
- Broken link HOT 1
- Overflow issue in the UI HOT 2
- Failed community solutions false positives HOT 10
- Nucleotide Count - Instructions doesn't fully correspond to the task HOT 3
- Strain - Instructions and tests HOT 4
- Wording on Luigi's luscious lasagna HOT 7
- The Lasagna exercise is duplicated HOT 3
- Elm logo HOT 4
- exercises: practice: tests: consider implementing some `include = false` tests
- Incorrectly formatted partial application concept header HOT 2
- Extra tag on exercise description HOT 3
- Concept: Opaque types
- Concept: Phantom types
- Discussion: concepts to implement HOT 11
- Concept: Strings HOT 5
- Concept: Random
- Concept: JSON Decoders HOT 6
- Investigate flaky tests
Recommend Projects
-
React
A declarative, efficient, and flexible JavaScript library for building user interfaces.
-
Vue.js
🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.
-
Typescript
TypeScript is a superset of JavaScript that compiles to clean JavaScript output.
-
TensorFlow
An Open Source Machine Learning Framework for Everyone
-
Django
The Web framework for perfectionists with deadlines.
-
Laravel
A PHP framework for web artisans
-
D3
Bring data to life with SVG, Canvas and HTML. 📊📈🎉
-
Recommend Topics
-
javascript
JavaScript (JS) is a lightweight interpreted programming language with first-class functions.
-
web
Some thing interesting about web. New door for the world.
-
server
A server is a program made to process requests and deliver data to clients.
-
Machine learning
Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.
-
Visualization
Some thing interesting about visualization, use data art
-
Game
Some thing interesting about game, make everyone happy.
Recommend Org
-
Facebook
We are working to build community through open source technology. NB: members must have two-factor auth.
-
Microsoft
Open source projects and samples from Microsoft.
-
Google
Google ❤️ Open Source for everyone.
-
Alibaba
Alibaba Open Source for everyone
-
D3
Data-Driven Documents codes.
-
Tencent
China tencent open source team.
from elm.