Hi all :wave: — I'm new to contributing here. I pi...
# dev
l
Hi all 👋 — I'm new to contributing here. I picked up good first issue #7647 (quickstart docs bug: the Actions & Hooks page doesn't mention that
check_commit_metadata.yml
needs to be created inside the
lakefs
container, not on the host). There was already a correct fix for this back in 2024 (#7675) but it went stale from inactivity and got auto-closed before merging. I noticed
docs/
no longer exists in
treeverse/lakeFS
— looks like docs moved to
treeverse/docs-lakeFS
, which now seems to hold pre-built HTML rather than markdown source. I left a comment on the issue asking about this but haven't heard back yet, so I went ahead and opened the fix there anyway: treeverse/docs-lakeFS#175. Would appreciate a review when someone has a moment — and happy to redirect the fix elsewhere if
docs-lakeFS
isn't the right place for it. Thanks!
heart lakefs 1
b
Hi Ashutosh, we archived the docs-lakeFS, it was the generated site that we published as the docs.lakefs.io and now we use a different source. Will produce a fix for the docs based on your report - thanks. Note that the latest documentation doesn't guide the user using docker.
l
Thanks for the quick confirmation, @Barak Amar! Closing the docs-lakeFS PR since it's archived — appreciate you taking it from here.
No worries — turns out
docs-lakeFS
is archived so I can't even close the PR there. Leaving it as-is, thanks again for taking this over!
b
No worries!
👍 1
l
Also @Barak Amar Couple of questions: 1. Is the docs source still publicly available somewhere I can contribute to, or is it fully internal to the lakeFS org now? 2. While running the quickstart end-to-end, I also found another docs bug: the “Uncommitted Changes” link is broken under the “Committing Changes in lakeFS” section. Happy to file an issue on treeverse/lakeFS for it — or route it wherever docs bugs should go now. Thanks!
b
1. Currently internal 2. In link you provided to the docs I don't see any link labeled "Uncommitted Changes" - are you talking about the quickstart document that is part of the sample repository? Can you point me to the dead link? If it is part of the sample/quickstart - the code is in the OSS repository and you can open and fix it there.
l
1. Got it. 2. Yes for the quickstart documentation when fired up locally. It's a very small thing but might confuse for new user navigating. Let me check this sample fix and will take it from there. Appreciate your prompt response.
b
Great - so for changes in this document you can open an issue and pr on lakeFS repository as I did in 10471, you can see the markdown template file that needs to be updated.
gratitude thank you 1