Description

Observed in nwolverson/vscode-ide-purescript#142:

When a fast rebuild is triggered and the rebuildCache^[1] is populated the documentation isn't preserved properly in that process.

To Reproduce

With a module like:

module A where

-- | MyType's documentation
type MyType = Int

I can't find the preventDefault function in halogen's API anymore, or see it mentioned in the docs. How do we do that now?

I'd also just like to say a massive thanks for halogen. The latest changes for version 1 make for a much nicer to use API and refactoring a couple of thousand line app was pretty painless. You guys rock!

How do we feel about merging the getting-started guide in this repo with the getting started chapter in the book?

I'm hoping that deduplicating the guides will make maintenance easier and be better for new users.

If all content of this repo's guide is incorporated

As far as I understand, with Spago and Purescript it is possible to use data types and functions coming from transitive dependencies (dependencies of declared dependencies).

This may cause problems if my declared dependency decides to remove one of its dependency which I'm using but not declaring.

To avoid such issues, it would be nice to have in Spago a command which checks that every funct

I see this note in initial announcement:

Please be aware that filtering by tag is still in development and only partially included in the latest release.

Waiting for this feature! But probably it's a good idea to document how to use it now if people want to play with this command.

While fixing #444 in a recent commit to development, I realized that the explanation comes 2 files after the file that introduces the where and let keywords. It should come immediately afterwards, so this must be fixed in a major breaking change.

it takes 5 minutes to complete on my computer

https://stackoverflow.com/a/42544963/3574379

shows

that there are pdf files in history and fonts

f2f4d706f8c0  358KiB docs/hyper.pdf
a2f47392424c  358KiB docs/hyper.pdf
218b6e7d8cda  358KiB docs/hyper.pdf
0a55271eac8e  358KiB docs/hyper.pdf
3a3026cc9570  358KiB docs/hyper.pdf
3185542167b2  358KiB docs/hyper.pdf
f93fc0431565  358

Probably it should at least have an updated message to explain what it's supposed to do more, and be prefixed that it is for package sets e.g. updates (package-sets) do whatever in the package set

Originally discussed here #128

• If TypeScript is so great, how come all notable ReactJS projects use Babel?
• TypeScript-Babel-Starter
• typescript-vs-flowtype
• [utility-types](https://github.com/piotrw

Currently compiling Data.Either.Nested takes about 10 seconds. It emits about 84k lines of code! So we should (a) investigate optimization passes to remove the lines to output and (b) make it run fast even when generating large files like that.

It's not too clear how (if) support for bundling multiple entry-points can be done with purs-loader. Currently for each entry point, it chucks all the ps in, leading to separate ps bundles being given a lot of unnecessary code that isn't present when just a single entrypoint is specified. This would be quite a nice feature.

Since all packages in a set will build together, it makes sense to generate all documentation at once, so that we can show things like links to instances in other modules.

We should probably think about how this applies to Pursuit in the longer term if the psc-package experiment is a success

@hdgarrood, any thoughts? I think we could potentially aim to have Pursuit build docs on a regular bas

Just a suggestion.

I've found your examples (from elm-architecture dir) really useful and after reading some of them I'm nearly confident that they are really self-contained and that they can be used as examples in pure "purescript/spork context".

I'm not sure if there should be a link to them from spork docs or if you should extract them into separate repo (and link it from this repositor

Building project in C:\Users~\purescript-presto\examples\billpay-react
Error 1 of 5:

at bower_components\purescript-strings\src\Data\String\NonEmpty\Internal.purs line 37, column 1 - line 37, column 1

Unable to parse module:
unexpected "else"
expecting declaration or end of input

See https://github.com/purescript/documentation/blob/master/errors/ErrorParsingModule.md

• Our types are a bit prettier by now
• Show the different kinds of imports and completions we support by now
• Show doc strings

We also added a bunch of features since I last updated the README.

Things I/we should document

• Editor mode
• Document a full .dir-locals.el file for easy copy-paste
• Talk about .projectile file trick to get the correct project root

Go through guides and update based on changes since the last release, and double check that all examples are still accurate

• Add notes on Body typeclass, along with different instances (String, Buffer, Stream.Readable, etc)
• Add notes on default headers (Content-Length, etc) and mechanism for overriding
• Add some notes on common path matching techniques and tools (th