From 6f4943d9dc87bfe5b4096055dc2f0afcfc6146c1 Mon Sep 17 00:00:00 2001 From: Jorge Orpinel Date: Thu, 20 Feb 2020 18:53:06 -0600 Subject: [PATCH 1/3] community: copy edits per https://github.com/iterative/dvc.org/issues/996#issuecomment-586495689 and https://github.com/iterative/dvc.org/issues/996#issuecomment-586544303 --- src/components/Community/Contribute/index.js | 11 ++++++----- src/components/Community/data.json | 14 +++++++------- 2 files changed, 13 insertions(+), 12 deletions(-) diff --git a/src/components/Community/Contribute/index.js b/src/components/Community/Contribute/index.js index 46a6c3480b..de93153a38 100644 --- a/src/components/Community/Contribute/index.js +++ b/src/components/Community/Contribute/index.js @@ -46,7 +46,8 @@ export default function CommunityContribute({ theme }) { } > - Become DVC contributor and let us build something great together. + Let's build something great together. Become a DVC + contributor!. @@ -64,8 +65,8 @@ export default function CommunityContribute({ theme }) { } > - Have something cool on your mind? Suggest a text and we'll - publish it in our blog. + We're always interested in guest writers for our blog. If you + have something to share, please reach out! @@ -103,8 +104,8 @@ export default function CommunityContribute({ theme }) { } > - Get perks and benefits for significant contributions, creating - content or hosting meetups. + Get perks and benefits for contributing to the code base, writing + blog posts, or hosting meetups. diff --git a/src/components/Community/data.json b/src/components/Community/data.json index ca3d264cac..da37d8f93a 100644 --- a/src/components/Community/data.json +++ b/src/components/Community/data.json @@ -7,22 +7,22 @@ "section": { "contribute": { "title": "Contribute", - "description": "DVC is 100% open-source and we welcome contributions of all sorts to our code and docs.", + "description": "DVC is 100% open source. We welcome contributions to our code and docs.", "mobileDescription": "PRs, Blog Posts, Talks, Ambassadors" }, "events": { "title": "Events", - "description": "Conferences, meetups and talks to learn more about DVC or meet in person.", + "description": "Learn more about DVC and meet us in person! We're appearing at conferences, meetups, and talks around the world.", "mobileDescription": "Come to hear more about DVC" }, "learn": { "title": "Learn", - "description": "Every month we are sharing here our news, findings, interesting reads, community takeaways, and everything along the way.", + "description": "There are many ways to learn about DVC: check out our documentation, our blogs and monthly Heartbeats, recommended reads, and more.", "mobileDescription": "Docs, Blog, User Content" }, "meet": { "title": "Community", - "description": "Ask questions, find answers, share your ideas and connect with DVC community.", + "description": "Ask questions, find answers, and connect with the DVC community.", "mobileDescription": "Chat, Forum, Github" } }, @@ -30,17 +30,17 @@ { "url": "/doc/get-started", "title": "Get started", - "description": "Learn how to set up your project" + "description": "Reproducible walkthroughs on advanced topics" }, { "url": "/doc/tutorials", "title": "Tutorials", - "description": "Learn how to solve most typical tasks" + "description": "Step-by-step introduction to basic DVC features" }, { "url": "/doc/changelog", "title": "Changelog", - "description": "See what's new in DVC core " + "description": "See what's new in DVC." } ], "userContent": [ From c2898af815af8de1502ed5e84875f6ed09682df6 Mon Sep 17 00:00:00 2001 From: Jorge Orpinel Date: Thu, 20 Feb 2020 19:03:39 -0600 Subject: [PATCH 2/3] cmd ref: typo --- public/static/docs/command-reference/gc.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/public/static/docs/command-reference/gc.md b/public/static/docs/command-reference/gc.md index 20ef13e36e..8b0041f57d 100644 --- a/public/static/docs/command-reference/gc.md +++ b/public/static/docs/command-reference/gc.md @@ -34,7 +34,7 @@ restored using `dvc fetch`, as long as they have previously been uploaded with ## Options - `-a`, `--all-branches` - keep cached objects referenced in all Git branches. - Useful for keeping data for all the latest experiment versions. Its + Useful for keeping data for all the latest experiment versions. It's recommended to consider including this option when using `-c` i.e. `dvc gc -ac`. From 25a771e8cf43e97cf965df08081c829c4ed8e584 Mon Sep 17 00:00:00 2001 From: Jorge Orpinel Date: Thu, 20 Feb 2020 19:03:46 -0600 Subject: [PATCH 3/3] user-guide: clarify that external cache for ext outs must be in same remote location --- public/static/docs/user-guide/managing-external-data.md | 5 +++-- 1 file changed, 3 insertions(+), 2 deletions(-) diff --git a/public/static/docs/user-guide/managing-external-data.md b/public/static/docs/user-guide/managing-external-data.md index af673517e8..9dbd2e2e0f 100644 --- a/public/static/docs/user-guide/managing-external-data.md +++ b/public/static/docs/user-guide/managing-external-data.md @@ -31,8 +31,9 @@ supported: In order to specify an external output for a stage file, use the usual `-o` or `-O` options of the `dvc run` command, but with the external path or URL to the file in question. For cached external outputs (`-o`) you will need -to [setup an external cache](/doc/command-reference/config#cache) location. -Non-cached external outputs (`-O`) do not require an external cache to be setup. +to [setup an external cache](/doc/command-reference/config#cache) in the same +remote location. Non-cached external outputs (`-O`) do not require an external +cache to be setup. > Avoid using the same remote location that you are using for `dvc push`, > `dvc pull`, `dvc fetch` as external cache for your external outputs, because