On 2 September 2016 at 19:46, Bryan Richter <[email protected]> wrote:
> > But I'd also rather have the default yaml be bare-bones, since in the > lifetime of my usage of stack, I'll only appreciate the verbose yaml > once[1]. It would be great if there was maybe just a link to an > example yaml one could download or copy if desired. I'd happily take a > 1-2 line comment in my "minimal" yaml if it meant it could be the > default format. > > [1] Harendra posits this isn't the case, and that sometimes even > experienced users can benefit from the reference. I'd much much rather > have a link to http://haskellstack.org/ as my "reference", rather than > a bunch of different versions of out-of-date "references" scattered > across my projects. I do not have strong opinions on this. I do like the clean config file and I guess most people will start getting annoyed by the comments at some point. In fact I add 'acme-box-0.0.0.0' to 'extra-deps' and then use 'stack solver --update-config' to clean the config :-) The biggest benefit is for beginners, experts would not need to use the reference most of the time. As you suggested, a possible compromise is to put a link at the top. I would want it to be a full syntax cheatsheet instead of a sample stack.yaml. The cheatsheet can have examples of all alternate syntaxes for each field and each field can be a hyperlink to the relevant section in the guide for more details. It can be presented in a much more readable way compared to the comments in stack.yaml. -harendra -- You received this message because you are subscribed to the Google Groups "haskell-stack" group. To unsubscribe from this group and stop receiving emails from it, send an email to [email protected]. To post to this group, send email to [email protected]. To view this discussion on the web visit https://groups.google.com/d/msgid/haskell-stack/CAPW%2BkkaN58LUp7666wSxdf6tnNHTUuiuykR2XYK1ho3M4HYgpw%40mail.gmail.com. For more options, visit https://groups.google.com/d/optout.
