haskell-servant / haskell-servant/haskell-servant.github.io

Version the tutorial

Open
#38 0 comments 0 reactions 0 assignees View on GitHub
Dominant language
Haskell
Stars
18
Forks
21
PR merge metrics
No merged PRs in 30d

Description

It would be nice to have multiple versions of the tutorial, corresponding to the major versions of `servant`. Preliminary work [here](https://github.com/haskell-servant/haskell-servant.github.io/compare/jkarni/versions?expand=1).

The way I'd propose to do this:
- [ ] Make separate branches for each version (e.g. `versions/0.4`, `versions/0.5`, etc.).
- [ ] Make a separate branch for non-tutorial changes.
- [ ] Make the `deploy.sh` script check what branch it's on.
- If one of the version branches, then copy over only the tutorial content into an appropriate version subdir (`tutorial/0.4/somecontent.html`).
- If the non-tutorial branch, only copy content outside of `tutorial` folder.
- [ ] Redirect `tutorial/somecontent.html` to `tutorial//somecontent.html`.
- [ ] Make sure links still work locally and on travis.

Contributor guide

No contributing guide indexed for this repository

Assessment

This issue has not been assessed yet.

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.