Skip to content

docs: add Installation guide link to README - #62

Merged
lovelydinosaur merged 2 commits into
mainfrom
add-installation-link-to-readme
Oct 7, 2026
Merged

lovelydinosaur merged 2 commits into
mainfrom
add-installation-link-to-readme

Conversation

@AllAboutDocs

Copy link
Copy Markdown
Collaborator

What

Adds a link to the Installation Guide (INSTALLATION.md) from the ## Installation section on the docs homepage (docs/README.md).

Why

The homepage's Installation section only shows the quick pip install mkdocs --pre command, with no pointer to the full guide added in #60 (uv install path, prerequisites, troubleshooting). This links the two together so a first-time user lands on the complete instructions.

Testing

Ran mkdocs serve locally and confirmed:

  • The section renders correctly on the homepage.
  • The "Installation guide" link navigates to a working /installation/ page.

@lovelydinosaur lovelydinosaur left a comment

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

Neat, thanks!
Also a good prompt to get the mkdocs check tooling in place.

Looks like there's a binary that's been accidentally committed.

@AllAboutDocs

Copy link
Copy Markdown
Collaborator Author

Fixed - removed the accidentally committed .DS_Store and confirmed it's already covered by .gitignore, so it shouldn't happen again. Ready for another look whenever you have a chance!

Comment thread .gitignore
venv/
dist/
site/
.DS_Store

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

This is specific to your operating system, so it's a little neater to keep this in global gitignore.

@lovelydinosaur
lovelydinosaur merged commit c03ca09 into main Oct 7, 2026
1 check passed
@lovelydinosaur
lovelydinosaur deleted the add-installation-link-to-readme branch October 7, 2026 11:57
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.

2 participants