Skip to content
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

add a note about reflinks and how space is calculated in the tutorial #139

Closed
efiop opened this issue Dec 16, 2018 · 5 comments · Fixed by #312
Closed

add a note about reflinks and how space is calculated in the tutorial #139

efiop opened this issue Dec 16, 2018 · 5 comments · Fixed by #312
Labels
A: docs Area: user documentation (gatsby-theme-iterative) 🐛 type: bug Something isn't working.

Comments

@efiop
Copy link
Contributor

efiop commented Dec 16, 2018

In our article https://dvc.org/doc/tutorial/define-ml-pipeline , we use du to show that space taken by the repo didn't double. That works with hardlinks, but du is not smart enough when it comes to reflinks, which it counts as separate full-blown filse and accounts for their size two times(for the cache file and for the reflink), which makes it confusing for the mac users iterative/dvc#1442 . We should add a note about it.

@efiop efiop added the A: docs Area: user documentation (gatsby-theme-iterative) label Dec 16, 2018
@efiop
Copy link
Contributor Author

efiop commented Dec 16, 2018

Note: to prove that no duplication occurs, we could use df utility to see that free space on the drive indeed didn't decline by the file size that we are adding.

@shcheklein shcheklein added 🐛 type: bug Something isn't working. tutorial labels Mar 25, 2019
@shcheklein shcheklein changed the title docs: add a note about reflinks add a note about reflinks and how space is calculated in the tutorial Mar 25, 2019
@kurianbenoy
Copy link
Contributor

Can I work on this issue?

@shcheklein
Copy link
Member

@kurianbenoy absolutely, feel free to start working on this! Join the dvc.org/chat and #dev-docs channel if you need any help.

@kurianbenoy
Copy link
Contributor

Add docs in tutorials about various link types in this page as well when documentation is ready for this.

@ghost
Copy link

ghost commented Aug 22, 2019

Someone got confused on Discord because the tutorial implies a cache type of hardlink / symlink / reflink
https://discordapp.com/channels/485586884165107732/485596304961962003

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
A: docs Area: user documentation (gatsby-theme-iterative) 🐛 type: bug Something isn't working.
Projects
None yet
Development

Successfully merging a pull request may close this issue.

3 participants