Open
Description
We've intended since #1224 to eventually merge the website into this repo, and between #2664 and HypothesisWorks/HypothesisWorks.github.io#30 I think we should do so soon. Points to consider:
- Merge the website repo into a
/website/
directory in this one, keeping the git history
Done in #2943: Merge hypothesis.works website repo into monorepo #3333 by @Macavirus 🎉 - Fix any bit-rot in the build system so that builds work nicely
- master...Zac-HD:website-revival throws out the old Jekyll build entirely to use Pelican (a pure-Python static site generator). Needs a nice theme; otherwise done - including deleting obsolete product and training pages.
- delete newsletter signup link The newsletter signup does not work correctly HypothesisWorks.github.io#35
- delete reference to long-dead Java prototype The site mentions proof of concept java version but not ruby version HypothesisWorks.github.io#36
- Add a live-preview for pull requests so that we can check changes
- Point 'production' to the new version (DNS? GitHub Pages config?)
- Ensure that
hypothesis.works
andhypothesis.readthedocs.org
prominently link to each other- Maybe we should host docs at
docs.hypothesis.works
?
- Maybe we should host docs at
- Write more blog posts, e.g. talking about the Ghostwriter or cool case studies
- article on the "expected result for explicit examples" trick
unknown_result = object() @example(x=1, expected=2) @example(x=2, expected=unknown_result) @given(x=st.integers(), expected=st.just(unknown_result)) def test(x, expected): result = f(x) assert 0 <= x # whatever properties you want if expected is not unknown_result: assert result == expected # if we know the exact output, assert that too!
- article on ghostwriter argument-guessing (Ghostwrite for many more names #3313); complete with list and link to online demo https://zhd.dev/ghostwriter/
- a "big list of properties" as recipes with Hypothesis, similar to this F# post
- update Hypothesis article about fixtures interaction with respect to this stackoverflow question.
- article on the "expected result for explicit examples" trick
Doesn't need to be in that exact order, but I think those are the main points.