doc: add new doc website #170
Conversation
ryantm
commented
Feb 26, 2023
ryantm
commented
- use mmdoc
- add github pages action to auto publish
- do not edit README for now, will follow up with a commit directs people to the doc site
ryantm
force-pushed
the
rtm-2-26-mmdoc
branch
3 times, most recently
from
d08276f to
f57185e
Compare
|
Not familiar with mmdoc, will check it out |
.github/workflows/doc.yml
Outdated
| - uses: cachix/install-nix-action@v18 | ||
| - run: nix build .#doc | ||
| - if: success() | ||
| uses: crazy-max/ghaction-github-pages@v3 |
There was a problem hiding this comment.
I generally prefer to go with the "official" actions instead of third-party (though I'm totally on board with cachix/install-nix-action). If interested, here's an example using the official actions/configure-pages and actions/deploy-pages actions: https://github.com/n8henrie/n8henrie-rs/blob/f02a99040fc85f791a63d50af7bf367e24df81dd/.github/workflows/docs.yml, the resulting GH pages: https://n8henrie.com/n8henrie-rs/n8henrie/ (was using it as a playground repo for GH docs).
There was a problem hiding this comment.
Good call out. I'd rather use some official one too. I'll check these out.
There was a problem hiding this comment.
Any idea what is going on here https://github.com/ryantm/agenix/actions/runs/4332366715/jobs/7565206043 ?
Error: Deployment failed, try again later.
https://github.com/ryantm/mmdoc Ah, cool -- it's your tool, and what you used for e.g. https://ryantm.github.io/nixpkgs/languages-frameworks/python/ (pages that I've been really grateful for!) |
* use mmdoc * add github pages action to auto publish * do not edit README for now, will follow up with a commit directs people to the doc site
