Skip to content

Docs Updates#949

Merged
aittalam merged 5 commits into
mainfrom
add-contributing-guide
Apr 30, 2026
Merged

Docs Updates#949
aittalam merged 5 commits into
mainfrom
add-contributing-guide

Conversation

@angpt
Copy link
Copy Markdown
Contributor

@angpt angpt commented Apr 23, 2026

  • Adds contributing guide + pr template
  • Updates docs links to Gitbook links

angpt and others added 4 commits April 16, 2026 12:36
Replace relative docs/ paths and add verified GitBook URLs
for all documentation links in README.md and README_0.10.0.md.
Update CONTRIBUTING.md to mention docs/SUMMARY.md when adding pages.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
Copy link
Copy Markdown
Member

@aittalam aittalam left a comment

Choose a reason for hiding this comment

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

Thank you @angpt !

I added a few comments/questions related to the CONTRIBUTING guide, everything else looks good as-is 🙏

Comment thread CONTRIBUTING.md Outdated

We welcome fixes, docs improvements, tests, build work, and larger feature work.

If your change touches the `llama.cpp/` submodule, also read [`llama.cpp/CONTRIBUTING.md`](llama.cpp/CONTRIBUTING.md). That file covers additional upstream expectations for code style, testing, and review.
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.

I am not sure whether this applies here. We do touch the submodules, but just with patches that allow us to work with them in our own project. Perhaps we should make it more clear that if we consider the change something that should end upstream, then it should become a PR to llama.cpp, otherwise it is sufficient to follow the instructions to modify submodules?

Comment thread CONTRIBUTING.md Outdated
- `unzip`
- Git

Windows contributors also need Cosmos bash.
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.

We should check if this is enough for building llamafile from scratch there.
I have tried MSYS2 for building dlls, and @javiermtorres replicated the build on WSL, but I think neither has tried cosmos bash.

Comment thread CONTRIBUTING.md
- Clarify submodule changes are patch-based; direct upstream changes should be PRs to the upstream repo
- Replace unverified "Cosmos bash" Windows prereq with MSYS2/WSL and link to building_dlls.md
- Add link to detailed submodule patch workflow docs
Copy link
Copy Markdown
Member

@aittalam aittalam left a comment

Choose a reason for hiding this comment

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

Many thanks @angpt , I think this is good to go! 🙏

@aittalam aittalam merged commit e487db2 into main Apr 30, 2026
2 checks passed
@aittalam aittalam deleted the add-contributing-guide branch April 30, 2026 11:01
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants