search

purescript / documentation

Documentation for the PureScript language, compiler, and tools.
Other
1.02k stars 301 forks source link

First draft of documentation update for v0.15 #421

Closed sigma-andex closed 2 years ago

sigma-andex commented 2 years ago

Overall looks good.

Should we create a tag in this repo of its state before any ES modules work gets merged and then link to that for everyone on pre-0.15.x?

Sounds good

JordanMartinez commented 2 years ago

Perhaps we shouldn't merge this until we're getting closer to the v0.15.0 release?

Regardless, I've made the pre-0.15.0-era tag.

sigma-andex commented 2 years ago

@JordanMartinez should we merge this already?

JordanMartinez commented 2 years ago

I think we'll do so immediately after the 0.15.0 release is made. See also #392

JordanMartinez commented 2 years ago

Hmm... Then again, this is the first draft, meaning there are other changes we might want to make. And I already have the 0.14-era tag made.

sigma-andex commented 2 years ago

@JordanMartinez should we merge this now?

JordanMartinez commented 2 years ago

@sigma-andex I don't think so. My main reasons against merging this now is because 0.15.0 isn't out yet. If it gets delayed by some other issue, then this repo's documentation will be incorrect, and it's one of the first things to which we direct new users.

On the other hand, we don't have a branch where we can iterate on the 0.15.0 updates to this repo. So, I think instead a new branch should be created 0.15.0-updates into which we merge this and #392. Then, we can iterate on that branch and then merge that branch into master once 0.15.0 comes out.