Skip to content

Improve binary caching documentation, make more salient #875

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 1 commit into from
Oct 13, 2020

Conversation

michaelpj
Copy link
Collaborator

People constantly ask about this, clearly without having found the
documentation that we do have about this. So we need to make it more
obvious:

  • Simplify the setup documentation to emphasize the Hydra cache (which
    is the only working one currently).
  • Move the cache troubleshooting section to the top to make it more
    obvious.
  • Highlight a link to the troubleshooting section of the docs in the
    README.
  • Emphasize that there is more documentation than is linked in the
    README.
  • Add a section to the README that explicitly mentions cache issues, and
    links to the corresponding sections of the docs.

People constantly ask about this, clearly without having found the
documentation that we do have about this. So we need to make it more
obvious:
- Simplify the setup documentation to emphasize the Hydra cache (which
is the only working one currently).
- Move the cache troubleshooting section to the top to make it more
obvious.
- Highlight a link to the troubleshooting section of the docs in the
README.
- Emphasize that there is more documentation than is linked in the
README.
- Add a section to the README that explicitly mentions cache issues, and
links to the corresponding sections of the docs.
Copy link
Contributor

@rvl rvl left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Thanks so much - I agree the emphasis is warranted.

@hamishmack hamishmack merged commit 1250f04 into master Oct 13, 2020
@iohk-bors iohk-bors bot deleted the imp/clarify-cache-docs branch October 13, 2020 02:37
booniepepper pushed a commit to booniepepper/haskell.nix that referenced this pull request Feb 4, 2022
…-hk#875)

People constantly ask about this, clearly without having found the
documentation that we do have about this. So we need to make it more
obvious:
- Simplify the setup documentation to emphasize the Hydra cache (which
is the only working one currently).
- Move the cache troubleshooting section to the top to make it more
obvious.
- Highlight a link to the troubleshooting section of the docs in the
README.
- Emphasize that there is more documentation than is linked in the
README.
- Add a section to the README that explicitly mentions cache issues, and
links to the corresponding sections of the docs.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

3 participants