From c56abebeda916821bfeed0033b5a9afbd1a1b45c Mon Sep 17 00:00:00 2001 From: rogermparent Date: Thu, 30 Apr 2020 23:53:40 -0400 Subject: [PATCH 1/5] Use upath in Gatsby foreign-file resolvers --- package.json | 3 ++- src/gatsby/utils/resolvers/index.js | 2 +- yarn.lock | 2 +- 3 files changed, 4 insertions(+), 3 deletions(-) diff --git a/package.json b/package.json index 7fd061e750..934c561a4f 100644 --- a/package.json +++ b/package.json @@ -78,7 +78,8 @@ "scroll": "^3.0.1", "serve-handler": "^6.1.2", "slick-carousel": "^1.8.1", - "unist-util-visit": "2.0.2" + "unist-util-visit": "2.0.2", + "upath": "^1.2.0" }, "devDependencies": { "@babel/core": "^7.9.0", diff --git a/src/gatsby/utils/resolvers/index.js b/src/gatsby/utils/resolvers/index.js index 4bba9815eb..0641a77aad 100644 --- a/src/gatsby/utils/resolvers/index.js +++ b/src/gatsby/utils/resolvers/index.js @@ -1,4 +1,4 @@ -const path = require('path') +const path = require('upath') /** Source Path Resolver Builder This function makes Gatsby resolvers that connect a node to another node via diff --git a/yarn.lock b/yarn.lock index f93158b1f9..078b6ff3bd 100644 --- a/yarn.lock +++ b/yarn.lock @@ -16982,7 +16982,7 @@ unset-value@^1.0.0: has-value "^0.3.1" isobject "^3.0.0" -upath@^1.1.1: +upath@^1.1.1, upath@^1.2.0: version "1.2.0" resolved "https://registry.yarnpkg.com/upath/-/upath-1.2.0.tgz#8f66dbcd55a883acdae4408af8b035a5044c1894" integrity sha512-aZwGpamFO61g3OlfT7OQCHqhGnW43ieH9WZeP7QxN/G/jS4jfqUkZxoryvJgVPEcrl5NL/ggHsSmLMHuH64Lhg== From d8ae3f8290538836fe89f909c3565be851ac46c6 Mon Sep 17 00:00:00 2001 From: Jorge Orpinel Date: Sat, 2 May 2020 16:44:11 -0500 Subject: [PATCH 2/5] blog: adding GSOD 2020 post --- content/authors/jorge_orpinel.md | 6 ++ content/blog/2020-04-30-gsod-ideas-2020.md | 93 +++++++++++++++++++++ static/uploads/avatars/jorge.jpg | Bin 0 -> 19486 bytes 3 files changed, 99 insertions(+) create mode 100644 content/authors/jorge_orpinel.md create mode 100644 content/blog/2020-04-30-gsod-ideas-2020.md create mode 100644 static/uploads/avatars/jorge.jpg diff --git a/content/authors/jorge_orpinel.md b/content/authors/jorge_orpinel.md new file mode 100644 index 0000000000..e26898ffb0 --- /dev/null +++ b/content/authors/jorge_orpinel.md @@ -0,0 +1,6 @@ +--- +name: Jorge Orpinel Pérez +avatar: jorge.jpg +--- + +Data scientist at [http://dvc.org](http://dvc.org) diff --git a/content/blog/2020-04-30-gsod-ideas-2020.md b/content/blog/2020-04-30-gsod-ideas-2020.md new file mode 100644 index 0000000000..88d095240e --- /dev/null +++ b/content/blog/2020-04-30-gsod-ideas-2020.md @@ -0,0 +1,93 @@ +--- +title: Join DVC for Google Season of Docs 2020 +date: 2020-04-30 +description: | + A call for writer applications for Google Season of Docs 2020. +descriptionLong: | + DVC is looking for writers to take part in + [Google Season of Code 2020](https://developers.google.com/season-of-docs). +picture: 2020-04-30/Season_of_Docs_small.png +pictureComment: +author: jorge_orpinel +commentsUrl: https://discuss.dvc.org/t/join-dvc-for-google-season-of-docs/317 +tags: + - Google Season of Docs + - Technical Writers + - Documentation + - Mentoring + - Writers +--- + +Exciting announcement! After a successful experience with +[Google Season of Docs](https://developers.google.com/season-of-docs) 2019, +we're putting out a call for writers to apply to work with DVC as part of the +[2020 edition](https://developers.google.com/season-of-docs). If you want to get +involved with open source software documentation with mentorship from our team, +read on. + +## Prerequisites to apply + +Besides the general requirements to apply to Google Season of Docs, there are a +few skills we look for in applicants. + +1. **Clear English writing.** We strive express the concepts, processes, and + details around DVC clearly, correctly, and completely. We use general and + friendly wording as much as possible and pay close attention to consistency + in our terminology. + +1. **Command line experience.** DVC is a command line tool that builds on top of + [Git](https://git-scm.com/), so being able to play with it and test the + features will be very useful. Creating and managing files, GNU/Linux + commands, file and permission admin are desired skills. + +1. **People skills.** We put a high value on communication: the ability to + discuss ideas, explain your goals, report progress, and work kindly with more + or less technical teammates. + +If you like our mission but aren't sure if you're sufficiently prepared, please +be in touch anyway. We'd love to hear from you. + +## Project ideas + +Below are several project ideas that are an immediate priority for the DVC docs +team. Of course, we welcome writers to create their own proposals, even if they +differ from our ideas. Projects will be primarily mentored by our in-house +technical writer, [Jorge Orpinel](https://github.com/jorgeorpinel). + +1. **One.** Our organization is a co-maintainer of the PyDrive library in + collaboration with a team at Google.. Because PyDrive is broadly used outside + of DVC, this project is a chance to work on a library of widespread interest + to the Python community. + + _Skills required:_ Python, Git, experience with APIs
_Difficulty + rating:_ Beginner-Medium

+ +1. **Two.** One of DVC’s features is the ability to create pipelines, linking + data repositories with code to process data, train models, and evaluate model + metrics... Furthermore, we’ll need to support building flags into DVC + commands that specify the level of parallelization (CPU, GPU or memory). + + _Skills required:_ Python, Git. Some experience with parallelization and/or + scientific computing would be helpful but not required. <
_Difficulty + rating:_ Advanced

+ +1. **Three.** A new DVC functionality that we’re particularly excited about is + `summon`, a method that can turn remotely-hosted machine learning artifacts + such as datasets, trained models, and more into objects in the user’s local + environment (such as a Jupyter notebook)... We’re looking for students to + explore other possible use cases. + + _Skills required:_ Python, Git, and some machine learning or data science + experience
_Difficulty rating:_ Beginner-Medium + +## If you'd like to apply + +Please refer to the +[Google Season of Docs](https://developers.google.com/season-of-docs) +application guides for specifics of the program. Writers looking to know more +about DVC, and our worldwide community of contributors, will learn most by +visiting our [Discord chat](https://dvc.org/chat), +[GitHub repository](https://github.com/iterative/dvc), and +[Forum](https://discuss.dvc.org/). We are available to discuss project proposals +from interested writers and can be reached by [email](mailto:support@dvc.org) or +on Discord. diff --git a/static/uploads/avatars/jorge.jpg b/static/uploads/avatars/jorge.jpg new file mode 100644 index 0000000000000000000000000000000000000000..6f331a9541b16742aba6fc201c5fc4dc28941076 GIT binary patch literal 19486 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 a-qHy_!HvJ56 Date: Sat, 2 May 2020 19:40:33 -0500 Subject: [PATCH 3/5] blog: GSOD ideas [WIP] --- content/authors/jorge_orpinel.md | 2 +- content/blog/2020-04-30-gsod-ideas-2020.md | 45 +++++++++++----------- 2 files changed, 23 insertions(+), 24 deletions(-) diff --git a/content/authors/jorge_orpinel.md b/content/authors/jorge_orpinel.md index e26898ffb0..c16cb52ab8 100644 --- a/content/authors/jorge_orpinel.md +++ b/content/authors/jorge_orpinel.md @@ -3,4 +3,4 @@ name: Jorge Orpinel Pérez avatar: jorge.jpg --- -Data scientist at [http://dvc.org](http://dvc.org) +Technical writer and developer at [http://dvc.org](http://dvc.org) diff --git a/content/blog/2020-04-30-gsod-ideas-2020.md b/content/blog/2020-04-30-gsod-ideas-2020.md index 88d095240e..b021f6bc3a 100644 --- a/content/blog/2020-04-30-gsod-ideas-2020.md +++ b/content/blog/2020-04-30-gsod-ideas-2020.md @@ -6,15 +6,16 @@ description: | descriptionLong: | DVC is looking for writers to take part in [Google Season of Code 2020](https://developers.google.com/season-of-docs). -picture: 2020-04-30/Season_of_Docs_small.png +picture: 2019-04-23/post-image.png pictureComment: author: jorge_orpinel -commentsUrl: https://discuss.dvc.org/t/join-dvc-for-google-season-of-docs/317 +commentsUrl: tags: - Google Season of Docs - Technical Writers - Documentation - Mentoring + - Open source - Writers --- @@ -35,10 +36,10 @@ few skills we look for in applicants. friendly wording as much as possible and pay close attention to consistency in our terminology. -1. **Command line experience.** DVC is a command line tool that builds on top of - [Git](https://git-scm.com/), so being able to play with it and test the - features will be very useful. Creating and managing files, GNU/Linux - commands, file and permission admin are desired skills. +1. **Command line experience.** [DVC](/doc/home) is a command line tool that + builds on top of [Git](https://git-scm.com/), so being able to play with it + and test the features will be very useful. Creating and managing files, + GNU/Linux commands, file and permission admin are desired skills. 1. **People skills.** We put a high value on communication: the ability to discuss ideas, explain your goals, report progress, and work kindly with more @@ -50,36 +51,34 @@ be in touch anyway. We'd love to hear from you. ## Project ideas Below are several project ideas that are an immediate priority for the DVC docs -team. Of course, we welcome writers to create their own proposals, even if they -differ from our ideas. Projects will be primarily mentored by our in-house -technical writer, [Jorge Orpinel](https://github.com/jorgeorpinel). +team. We welcome writers to create their own proposals, even if they differ from +our ideas. Projects will be primarily mentored by our lead technical writer, +[Jorge](https://github.com/jorgeorpinel). -1. **One.** Our organization is a co-maintainer of the PyDrive library in - collaboration with a team at Google.. Because PyDrive is broadly used outside - of DVC, this project is a chance to work on a library of widespread interest - to the Python community. +1. **How-to section.** Foo. _Skills required:_ Python, Git, experience with APIs
_Difficulty rating:_ Beginner-Medium

-1. **Two.** One of DVC’s features is the ability to create pipelines, linking - data repositories with code to process data, train models, and evaluate model - metrics... Furthermore, we’ll need to support building flags into DVC - commands that specify the level of parallelization (CPU, GPU or memory). +1. **Tutorials -> Blog.** Bar. _Skills required:_ Python, Git. Some experience with parallelization and/or - scientific computing would be helpful but not required. <
_Difficulty + scientific computing would be helpful but not required.
_Difficulty rating:_ Advanced

-1. **Three.** A new DVC functionality that we’re particularly excited about is - `summon`, a method that can turn remotely-hosted machine learning artifacts - such as datasets, trained models, and more into objects in the user’s local - environment (such as a Jupyter notebook)... We’re looking for students to - explore other possible use cases. +1. **Interactive guides.** Baz. _Skills required:_ Python, Git, and some machine learning or data science experience
_Difficulty rating:_ Beginner-Medium +1. **User Guide.** Zoo. + + _Skills required:_ Python, Git, experience with APIs
_Difficulty + rating:_ Beginner-Medium

+ +> For more inspiration, feel free to review our open +> [documentation issues](https://github.com/iterative/dvc.org/issues?q=is%3Aopen+is%3Aissue+label%3Adoc-content+). + ## If you'd like to apply Please refer to the From 7565e669891872d6858006ea67b7a1c6d8191fca Mon Sep 17 00:00:00 2001 From: Jorge Orpinel Date: Sat, 2 May 2020 21:14:50 -0500 Subject: [PATCH 4/5] blog: GSOD project ideas --- content/blog/2020-04-30-gsod-ideas-2020.md | 46 ++++++++++++---------- 1 file changed, 26 insertions(+), 20 deletions(-) diff --git a/content/blog/2020-04-30-gsod-ideas-2020.md b/content/blog/2020-04-30-gsod-ideas-2020.md index b021f6bc3a..6ec1553c51 100644 --- a/content/blog/2020-04-30-gsod-ideas-2020.md +++ b/content/blog/2020-04-30-gsod-ideas-2020.md @@ -55,26 +55,32 @@ team. We welcome writers to create their own proposals, even if they differ from our ideas. Projects will be primarily mentored by our lead technical writer, [Jorge](https://github.com/jorgeorpinel). -1. **How-to section.** Foo. - - _Skills required:_ Python, Git, experience with APIs
_Difficulty - rating:_ Beginner-Medium

- -1. **Tutorials -> Blog.** Bar. - - _Skills required:_ Python, Git. Some experience with parallelization and/or - scientific computing would be helpful but not required.
_Difficulty - rating:_ Advanced

- -1. **Interactive guides.** Baz. - - _Skills required:_ Python, Git, and some machine learning or data science - experience
_Difficulty rating:_ Beginner-Medium - -1. **User Guide.** Zoo. - - _Skills required:_ Python, Git, experience with APIs
_Difficulty - rating:_ Beginner-Medium

+1. **How-to section.** We have compiles a + [set of topics](https://github.com/iterative/dvc.org/issues/899) that we + think would be best explained in a new "How to" section of our docs. This + will imply relocating bits and pieces of info from existing docs into new + how-tos, as well as writing significant new material to complete them. + + _Difficulty rating:_ Beginner-Medium

+ +1. **Tutorials to Blog.** DVC is currently rewriting it's main tutorial, the + [Get Started](https://github.com/iterative/dvc.org/pull/1074). The remaining + [Tutorials](https://dvc.org/doc/tutorials) will then become somewhat + redundant so we are considering moving them out of the docs and into blog + posts instead. Other possible rearrangements of the tutorials may end up + being preferred. + + _Difficulty rating:_ Medium-Advanced

+ +1. **Integrate interactive guides.** We have a set of + [Katacoda scenarios](https://www.katacoda.com/dvc) to match different + sections of our docs. These need to be checked and updated, as well as + embedded into the corresponding pages per + [this issue](https://github.com/iterative/dvc.org/issues/670). This would + involve working with our front-end team or, preferably, having some + Javascript coding experience. + + _Difficulty rating:_ Advanced > For more inspiration, feel free to review our open > [documentation issues](https://github.com/iterative/dvc.org/issues?q=is%3Aopen+is%3Aissue+label%3Adoc-content+). From b9f55c7baea4077e9d07952ef6c62f5314cc01da Mon Sep 17 00:00:00 2001 From: Jorge Orpinel Date: Sun, 3 May 2020 20:42:44 -0500 Subject: [PATCH 5/5] blog: rewrite project ideas after feedback from Ivan --- content/blog/2020-04-30-gsod-ideas-2020.md | 91 +++++++++++++++------- 1 file changed, 65 insertions(+), 26 deletions(-) diff --git a/content/blog/2020-04-30-gsod-ideas-2020.md b/content/blog/2020-04-30-gsod-ideas-2020.md index 6ec1553c51..abbddbcbe4 100644 --- a/content/blog/2020-04-30-gsod-ideas-2020.md +++ b/content/blog/2020-04-30-gsod-ideas-2020.md @@ -5,18 +5,15 @@ description: | A call for writer applications for Google Season of Docs 2020. descriptionLong: | DVC is looking for writers to take part in - [Google Season of Code 2020](https://developers.google.com/season-of-docs). + [Google Season of Docs 2020](https://developers.google.com/season-of-docs). picture: 2019-04-23/post-image.png pictureComment: author: jorge_orpinel -commentsUrl: +commentsUrl: https://discuss.dvc.org/t/join-dvc-for-google-season-of-docs-2020/375 tags: - Google Season of Docs - - Technical Writers - Documentation - Mentoring - - Open source - - Writers --- Exciting announcement! After a successful experience with @@ -26,6 +23,11 @@ we're putting out a call for writers to apply to work with DVC as part of the involved with open source software documentation with mentorship from our team, read on. +DVC has a well organized docs team and a +[well-defined process](https://dvc.org/doc/user-guide/contributing/docs) for +creating and maintaining our documentation, while working closely with the core +engineering team. + ## Prerequisites to apply Besides the general requirements to apply to Google Season of Docs, there are a @@ -55,35 +57,72 @@ team. We welcome writers to create their own proposals, even if they differ from our ideas. Projects will be primarily mentored by our lead technical writer, [Jorge](https://github.com/jorgeorpinel). -1. **How-to section.** We have compiles a - [set of topics](https://github.com/iterative/dvc.org/issues/899) that we - think would be best explained in a new "How to" section of our docs. This - will imply relocating bits and pieces of info from existing docs into new - how-tos, as well as writing significant new material to complete them. +1. **DVC 1.0 docs.** We are soon to release DVC 1.0.0! This version brings some + significant changes that for the first time in our + [release history](https://github.com/iterative/dvc/releases) are not + completely backward-compatible. The main change is a multi-stage _pipelines + file_ that substitutes + [DVC-files](https://dvc.org/doc/user-guide/dvc-file-format). We expect the + process to fully update all our previous docs will take a few months, and you + could help us with this! _Difficulty rating:_ Beginner-Medium

-1. **Tutorials to Blog.** DVC is currently rewriting it's main tutorial, the - [Get Started](https://github.com/iterative/dvc.org/pull/1074). The remaining - [Tutorials](https://dvc.org/doc/tutorials) will then become somewhat - redundant so we are considering moving them out of the docs and into blog - posts instead. Other possible rearrangements of the tutorials may end up - being preferred. +1. **Video tutorials.** Written documentation is great, but other media can also + be important for our organization to reach a wide variety of learners. + Expanding to video is also a core part of our developer advocacy strategy. + One of DVC's priorities for the season is creating a library of video + tutorials ranging from short explanations of basic DVC functions to more + advanced use cases. You could assist in writing the scripts or even take the + lead producing some videos, so image/video editing skills would come in handy + (optional). + + **Mentor**: [Elle](https://github.com/andronovhopf) + + _Difficulty rating:_ Medium

- _Difficulty rating:_ Medium-Advanced

+1. **Interactive guides.** Many of our docs include command line examples to + illustrate how DVC works. In some cases these are full guides we want people + to be able to follow by copying commands into their terminals. This has a few + challenges: mainly keeping the rest of the document maintainable, brief, and + easy to read; and supporting people on all platforms (Mac, Windows, Linux). -1. **Integrate interactive guides.** We have a set of - [Katacoda scenarios](https://www.katacoda.com/dvc) to match different - sections of our docs. These need to be checked and updated, as well as + So we started extracting some of the command examples into interactive + [Katacoda scenarios](https://www.katacoda.com/dvc) to match certain docs, + however they are in need of maintenance and completion, as well as being embedded into the corresponding pages per - [this issue](https://github.com/iterative/dvc.org/issues/670). This would - involve working with our front-end team or, preferably, having some - Javascript coding experience. + [this issue](https://github.com/iterative/dvc.org/issues/670). - _Difficulty rating:_ Advanced + This may involve working with our front-end team or, preferably, having some + Javascript coding experience. -> For more inspiration, feel free to review our open -> [documentation issues](https://github.com/iterative/dvc.org/issues?q=is%3Aopen+is%3Aissue+label%3Adoc-content+). + _Difficulty rating:_ Medium-Advanced + +1. **Javascript engine UI/UX.** Our website has custom + [source code](https://github.com/iterative/dvc.org/tree/master/src) we've + developed over the years to host our landing pages, docs, and blog all in a + high-performance, advanced static site (Node.js, Gatsby, React, Typescript). + We have several goals to further improve the usability and structure of our + site, such as + + - creating a + [special docs home page](https://github.com/iterative/dvc.org/issues/1073). + - improving [mobile menus](https://github.com/iterative/dvc.org/issues/808). + - better navigation sidebar + [highlighting](https://github.com/iterative/dvc.org/issues/753) and + [positioning](https://github.com/iterative/dvc.org/issues/1198). + + > See other + > [doc-engine](https://github.com/iterative/dvc.org/issues?q=is%3Aopen+is%3Aissue+label%3Adoc-engine) + > and + > [blog-engine](https://github.com/iterative/dvc.org/issues?q=is%3Aopen+is%3Aissue+label%3Ablog-engine) + > issues. + + _Difficulty rating:_ Advanced

+ +> For more inspiration, feel free to review our +> [epics](https://github.com/iterative/dvc.org/labels/epic) and other open docs +> [issues](https://github.com/iterative/dvc.org/issues?q=is%3Aopen+is%3Aissue+label%3Adoc-content+). ## If you'd like to apply