Skip to content

Conversation

@utkarshsingh99
Copy link
Contributor

@utkarshsingh99 utkarshsingh99 commented May 22, 2020

Additional, final fix #898
Specific addition: #898(comment)
Please check the link of the non-DVC git repository. I couldn't find any non-DVC repo in iterative that could provide for a dataset file. In case of any modifications, I would be happy to make changes to the link.

  • ❗ Please read the guidelines in the Contributing to the Documentation list if you make any substantial changes to the documentation or JS engine.

  • 🐛 Please make sure to mention Fix #issue (if applicable) in the description of the PR. This causes GitHub to close it automatically when the PR is merged.

  • Please choose to allow us to edit your branch when creating the PR.

Thank you for the contribution - we'll try to review it as soon as possible. 🙏

```dvc
$ dvc import git@github.com:GSA/data \
enterprise-architecture/it-standards.csv
Importing 'enterprise-architecture/it-standards.csv
Copy link
Contributor

Choose a reason for hiding this comment

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

minor: is the output actually split? if not - let's keep it as-is, for output we tend to preserve it as we have it in DVC

Copy link
Contributor Author

Choose a reason for hiding this comment

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

Okay, but that makes the code div scrollable. Is that okay?

Copy link
Contributor

Choose a reason for hiding this comment

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

yes, it's fine ... it's better to keep it close to the actual output

Copy link
Contributor

@jorgeorpinel jorgeorpinel May 24, 2020

Choose a reason for hiding this comment

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

Hm I would personally prefer non-scrollable code/cli samples. No right or wrong answer here but for consistency should we go for non-scrolling? Most code/CLI samples try to avoid the horizontal scrolling AFAIR (that means up to 72 character-long lines).

Copy link
Contributor

@shcheklein shcheklein May 24, 2020

Choose a reason for hiding this comment

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

there are two types of lines:

  1. commands - start with $. It's reasonable to avoid the horizontal scroll. There is a mechanism for that - \.
  2. output - this is one is not that simple. If we start splitting output w/o any special sign that we wrapped it there is a danger at some point that we can get a different semantic for it. If it looks like it's too much I would try simplify with ... instead, or something like that. But not silently introduce newlines that are actually not there.

Copy link
Contributor

Choose a reason for hiding this comment

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

Good points, I use ... often to shorten these output lines. No need to keep the whole thing, just give an idea of what to expect from running commands and only when absolutely needed (best to avoid sample command output altogether). Please note, @utkarshsingh99

Copy link
Contributor

@shcheklein shcheklein left a comment

Choose a reason for hiding this comment

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

looks cool 😎 , just one minor comment

@shcheklein shcheklein requested a review from jorgeorpinel May 22, 2020 22:07
@shcheklein shcheklein temporarily deployed to dvc-landing-master-uzqmdn4bfpi May 23, 2020 15:31 Inactive
@jorgeorpinel
Copy link
Contributor

jorgeorpinel commented May 24, 2020

Additional, final fix for #898

@utkarshsingh99 please link the PR properly to the original issue so it's closed automatically when this PR merges. See https://help.github.com/en/github/managing-your-work-on-github/linking-a-pull-request-to-an-issue


For future reference, I would also suggest to link directly to the specific comment this addresses in the description for context (optional) like this: #898 (comment) and/or even quote the task description:

the only thing missing is to add an example specific to importing Git-tracked files.

Copy link
Contributor

@jorgeorpinel jorgeorpinel left a comment

Choose a reason for hiding this comment

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

Sorry for the delay, here's my feedback. Great so far but needs a little bit of polishing the details.

Co-authored-by: Jorge Orpinel <jorgeorpinel@users.noreply.github.com>
@shcheklein shcheklein temporarily deployed to dvc-landing-master-uzqmdn4bfpi May 25, 2020 06:01 Inactive
- Moved example to the bottom of all examples
- Shortened YAML code output block
- Explained YAML code concisely
- Updated 4 semantic changes suggested by @jorgeorpinel
- Shortened output of `import` command as suggested by @jorgeorpinel & @shcheklein
@shcheklein shcheklein temporarily deployed to dvc-landing-master-uzqmdn4bfpi May 25, 2020 06:29 Inactive
- Resolved `dvc update` in page link
- Prettier formatting
@shcheklein shcheklein temporarily deployed to dvc-landing-master-uzqmdn4bfpi May 25, 2020 10:16 Inactive
@jorgeorpinel
Copy link
Contributor

jorgeorpinel commented May 26, 2020

I'm sorry for failing the test at the last commit.
Forgot about the 80 symbols width rule for a moment.
Is there anything I can do

Yep, you can fix the formatting manually or with Prettier. The docs contrib guide explains how to use it and set it up, in fact it should be automatic if you have installed the app locally. But please reach out to us on Discord if you're having troubles or questions regarding this.

(I'm unable to execute the git merge --ff-only ... command for some reason, thus can't update the PR from the local code)

I didn't understand this part, sorry. What are you trying to merge to what?

@shcheklein shcheklein temporarily deployed to dvc-landing-master-uzqmdn4bfpi May 26, 2020 22:04 Inactive
@utkarshsingh99
Copy link
Contributor Author

in fact it should be automatic if you have installed the app locally.

Actually I was working on another issue locally so I thought it would get complicated to add and commit specific files only depending on issues. But I realize now that would still be way better than failing these tests.

I didn't understand this part, sorry. What are you trying to merge to what?

This is regarding the duplicate PR #1354 of #1339 which had some instructions for the contributor to incorporate changes manually. I was stuck at this command in the instructions

@jorgeorpinel

This comment has been minimized.

@jorgeorpinel
Copy link
Contributor

This is regarding the duplicate PR #1354 which had some instructions for the contributor to incorporate changes manually. I was stuck at this command in the instructions

Ah yes, option no # 2 you should be able to do when there's a Restyled PR. That is to merge that automatic branch from the upstream back to your own branch. I'm curious why you weren't able to merge it, please share the commands and output next time if that happens.

@jorgeorpinel jorgeorpinel temporarily deployed to dvc-landing-master-uzqmdn4bfpi May 28, 2020 02:31 Inactive
@jorgeorpinel
Copy link
Contributor

Another good one! Thanks @utkarshsingh99 I hope this helps you get closer to start planning your GSoD project idea application.

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.

cmd ref: update import: it now supports non-DVC Git repos

3 participants