add recipe introducing servant-pagination

[KtorZ]

As proposed in #125, here's a short introduction to servant-pagination.

Feedback is welcome :)

[alpmestan]

@KtorZ Haven't yet looked at the explanations (I won't be too picky though, don't worry), but is there a reason why your patch comes with both a Main.hs and a Pagination.lhs, with the code duplicated in both?

See 5ac6de8 for an example of commit that adds a cookbook recipe with the code and explanations in a single file. The trick is to have:

  ghc-options:         -pgmL markdown-unlit
  build-tool-depends: markdown-unlit:markdown-unlit

in the .cabal file. This processes the file with markdown-unlit (which strips away all the markdown, only leaving the code) before giving its contents to GHC.

[KtorZ]

Ah! You're entirely right, I wrongly committed that. I'll update 👍

[KtorZ]

Done 👍
Let me know :)

[alpmestan]

Looks great, thank you for taking the time to write it all down!

[alpmestan]

for each HasPagination instance, I suppose?

[KtorZ]

Indeed!

hide in shame

[KtorZ]

Fixed in 93838ae

[alpmestan]

Thanks @KtorZ!

Your recipe should appear on https://haskell-servant.readthedocs.io/en/latest/cookbook/index.html (note the latest in the URL, which reflects the docs for the master branch, as opposed to stable which has the docs for the latest release) soon (15 mins IIRC? something along those lines).

[KtorZ]

Awesome! 🎉

[alpmestan]

Here it is: https://haskell-servant.readthedocs.io/en/latest/cookbook/pagination/Pagination.html :-)

[ysangkok]

@KtorZ the pagination library is missing a bunch of dependency bound updates, are you still maintaining this? I think it would be best if either the repo became part of this org, or that we removed it.

[KtorZ]

I am not directly since it's part of the Chordify organization which I am (unfortunately ❤️) no longer working with.
I don't know if they're still keen on maintaining it but perhaps @jbransen can chime in.

[jbransen]

@isomorpheme ^

[isomorpheme]

Chiming in as one of the Chordify people with open source responsibility. :) If the dependency bounds can be fixed purely via a Hackage revision then @swamp-agr should be able to do that; if not I'd be happy to review a patch.

In general I expect we'll maintain it just to the degree that we need for internal use - we're open to PRs of course but I've noticed that reviewing those tends to drift down to the bottom of my todo list. So with that in mind I wouldn't mind at all to transfer the repo to this org (but removing the cookbook instead is also fine by me).

[ysangkok]

Patch submitted , @isomorpheme :

• Bump servant, servant-server, text chordify/haskell-servant-pagination#24

[ysangkok]

@isomorpheme Please review the linked patch, it seems like swamp-agr is not available.