Skip to content
This repository has been archived by the owner on Oct 16, 2024. It is now read-only.

ref: doctor + #259

Merged
merged 7 commits into from
Dec 22, 2022
Merged

ref: doctor + #259

merged 7 commits into from
Dec 22, 2022

Conversation

aguschin
Copy link
Contributor

@aguschin aguschin commented Dec 9, 2022

No description provided.

@aguschin aguschin self-assigned this Dec 9, 2022
@shcheklein shcheklein temporarily deployed to mlem-ai-gto-docs-mlem-cysxgwtl December 9, 2022 07:33 Inactive
@github-actions
Copy link

github-actions bot commented Dec 9, 2022

Link Check Report

There were no links to check!

@aguschin
Copy link
Contributor Author

@jorgeorpinel, could I ask you for a review? Also, there were some questions we didn't complete discussion of in #235, if you want we can complete it and make necessary updates in this PR.

@shcheklein shcheklein temporarily deployed to mlem-ai-gto-docs-mlem-cysxgwtl December 13, 2022 11:05 Inactive
@shcheklein shcheklein temporarily deployed to mlem-ai-gto-docs-mlem-cysxgwtl December 15, 2022 12:21 Inactive
@shcheklein shcheklein temporarily deployed to mlem-ai-gto-docs-mlem-cysxgwtl December 16, 2022 05:48 Inactive
@shcheklein shcheklein temporarily deployed to mlem-ai-gto-docs-mlem-cysxgwtl December 16, 2022 07:17 Inactive
@aguschin
Copy link
Contributor Author

@jorgeorpinel, a friendly ping 🎅🏻 🎄

@shcheklein shcheklein temporarily deployed to mlem-ai-gto-docs-mlem-cysxgwtl December 22, 2022 05:56 Inactive
@aguschin
Copy link
Contributor Author

@jorgeorpinel, I'm merging this to make it available for users, but will be happy to hear suggestions for improvements.

@aguschin aguschin merged commit 11b1b8c into main Dec 22, 2022
@aguschin aguschin deleted the gto-docs-mlem branch December 22, 2022 14:40
@jorgeorpinel
Copy link
Contributor

Sorry, this one fell through the cracks. Checking now 🙂

Comment on lines +669 to +672
{
"slug": "doctor",
"source": "doctor.md",
"label": "doctor"
Copy link
Contributor

Choose a reason for hiding this comment

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

The cmd ref changes are completely unrelated, right? Is the generator script running automatically whenever you change anything? Otherwise 🙏🏼 let's make separate PRs for ease of review in the future. Thanks

Copy link
Contributor Author

Choose a reason for hiding this comment

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

Yes, they are unrelated. It doesn't run automatically, I do that manually. But, I can do that in separate PRs in future, sure.

Copy link
Contributor

@jorgeorpinel jorgeorpinel Dec 25, 2022

Choose a reason for hiding this comment

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

Thanks! Actually this PR was mostly about that now that I see haha. So I just changed the title 😬 and labels

@jorgeorpinel jorgeorpinel added A: docs Area: user documentation (gatsby-theme-iterative) C: user-guide Content of /doc/user-guide C: ref Content of /doc/{command,api,object}-reference labels Dec 24, 2022
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.

Comments on cmd ref updates 👇🏼

Comment on lines +49 to +52
`--custom` option allows you to add custom metadata. Within `gto annotate` GTO
treats input as string, but you can edit artifacts.yaml to add arbitrary
information that fits yaml format, such as dict or list, or more complex
structures.
Copy link
Contributor

Choose a reason for hiding this comment

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

Doesn't seem important enough to be the only option explained directly in the Description. Probably adding to the Options section is enough?

Comment on lines +31 to +36
Note, that for local repos the `artifacts.yaml` is read from the workspace
without Git, so if you have uncommitted changes, they will be reflected in the
output. If you want to read from specific commit, you need to specify `--rev`
option.

You can also get annotation for specific versions (these are the same shortcuts
Copy link
Contributor

Choose a reason for hiding this comment

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

The first part is expected, I think. We can simplify this

Suggested change
Note, that for local repos the `artifacts.yaml` is read from the workspace
without Git, so if you have uncommitted changes, they will be reflected in the
output. If you want to read from specific commit, you need to specify `--rev`
option.
You can also get annotation for specific versions (these are the same shortcuts
If you want to read information from previous commits, specify a `--rev`.
You can also get annotation for specific artifact versions (same shortcuts

content/docs/gto/command-reference/doctor.md Show resolved Hide resolved
@jorgeorpinel
Copy link
Contributor

The changes to content/docs/gto/user-guide/mlem.md seem minimal, so I guess this PR was mostly about the cmd ref. The wording in the MLEM and DVC guides is confusing at times but that was an issue already. Hopefully we'll get to reviewing the grammar and trying to simplify the docs in general soon (let's plan it?) Thanks

@jorgeorpinel jorgeorpinel removed the C: user-guide Content of /doc/user-guide label Dec 24, 2022
@jorgeorpinel jorgeorpinel changed the title Docs: add "GTO with MLEM" page ref: gto doctor + Dec 24, 2022
@jorgeorpinel jorgeorpinel changed the title ref: gto doctor + ref: doctor + Dec 24, 2022
Sign up for free to subscribe to this conversation on GitHub. Already have an account? Sign in.
Labels
A: docs Area: user documentation (gatsby-theme-iterative) C: ref Content of /doc/{command,api,object}-reference
Projects
No open projects
Status: Done
Development

Successfully merging this pull request may close these issues.

4 participants