Style guide (code / syntax)

[paulyoung]

Not to be confused with the guidelines for writing libraries, but something more in the style of Elm's style guide or NoRedInk's Elm Style Guide.

[texastoland]

@paulyoung This is on my personal todo! I have concrete ideas if you'd like to coordinate? I was thinking of publishing it with GitBook for a whirlwind syntax tour.

[paulyoung]

Sounds great!

I may be providing more questions than answers 😄

[texastoland]

Sweet I'll gather my thoughts into a repo today!!

[texastoland]

@paulyoung I'm starting here if you wanna follow along. I'll publish conventions first based on several Haskell and Elm guides. NB for pedagogical sake it won't follow the style of our Prelude or compiler.

[paulyoung]

@AppShipIt sounds good. Feel free to ping me if you make updates.

[tfausak]

I think this should go hand-in-hand with #23.

[texastoland]

I think #23 should be more flexible. At work I've pointed out the current conventions I deem awful e.g. vertical indentation. We're using recommendations based on Elm which I'll add to purescript-4humans.

[garyb]

What's "vertical indentation"?

[natefaubion]

purescript-4humans

Next: purescript-4dolphins :wink:

[tfausak]

data Maybe a = Nothing
             | Just a
          -- ^ Lining this up is "vertical indentation".

Edit: ... I think.

[garyb]

The Elm style guide is against that too I thought? Unless I'm misunderstanding @AppShipIt.

:+1: for not doing that.

[texastoland]

Right. Definitely planning on getting feedback!

[dkoontz]

👍 for this. I've also been using the Elm style guide for PS at work and it's been very nice.

[ianbollinger]

I started work on one here, if anyone is interested.

[paf31]

Moving to the docs repo.