From 90396b2a0484658acc052009f7bd89d6fc66e380 Mon Sep 17 00:00:00 2001 From: Madison Swain-Bowden Date: Tue, 17 Oct 2023 22:42:15 -0700 Subject: [PATCH] Move catalog README to docs site quickstart (#3204) --- documentation/catalog/guides/index.md | 1 + .../catalog/guides/quickstart.md | 32 +++++++------------ 2 files changed, 12 insertions(+), 21 deletions(-) rename catalog/README.md => documentation/catalog/guides/quickstart.md (91%) diff --git a/documentation/catalog/guides/index.md b/documentation/catalog/guides/index.md index 1427b355153..24fd9270037 100644 --- a/documentation/catalog/guides/index.md +++ b/documentation/catalog/guides/index.md @@ -3,5 +3,6 @@ ```{toctree} :titlesonly: +quickstart deploy ``` diff --git a/catalog/README.md b/documentation/catalog/guides/quickstart.md similarity index 91% rename from catalog/README.md rename to documentation/catalog/guides/quickstart.md index f19a780cac3..08e37d7de45 100644 --- a/catalog/README.md +++ b/documentation/catalog/guides/quickstart.md @@ -1,10 +1,4 @@ - - -

- Project Board | Community Site | #openverse @ Slack | Handbook | Figma Mockups | Figma Design Library -

- -# Openverse Catalog +# Quickstart This repository contains the methods used to identify over 1.4 billion Creative Commons licensed works. The challenge is that these works are dispersed @@ -22,7 +16,7 @@ the internet. ### API Workflows To view more information about all the available workflows (DAGs) within the -project, see [DAGs.md](catalog/DAGs.md). +project, see [DAGs.md](../reference/DAGs.md). See each provider API script's notes in their respective [handbook][ov-handbook] entry. @@ -64,7 +58,8 @@ The steps above were performed in [`ExtractCCLinks.py`][ex_cc_links]. This method was retired in 2021. [ccrawl_doc]: https://commoncrawl.org/the-data/get-started/ -[ex_cc_links]: archive/ExtractCCLinks.py +[ex_cc_links]: + https://github.com/WordPress/openverse/blob/c20262cad8944d324b49176678b16b230bc57e2e/archive/ExtractCCLinks.py ## Development setup for Airflow and API puller scripts @@ -75,9 +70,10 @@ different environment than the PySpark portion of the project, and so have their own dependency requirements. For instructions geared specifically towards production deployments, see -[DEPLOYMENT.md](DEPLOYMENT.md) +[DEPLOYMENT.md](https://github.com/WordPress/openverse/blob/main/catalog/DEPLOYMENT.md) -[api_scripts]: catalog/dags/providers/provider_api_scripts +[api_scripts]: + https://github.com/WordPress/openverse/blob/main/catalog/dags/providers/provider_api_scripts ### Requirements @@ -226,9 +222,10 @@ just recreate > `DC_USER=root` environment variable for `just` recipes. For example, see the > [generate-dag-docs recipe](https://github.com/WordPress/openverse-catalog/blob/c9be67e483e49e9eda7cd21b52bcde8857cd3922/justfile#L126). -[justfile]: justfile -[dockercompose]: catalog/docker-compose.yml -[cc_airflow]: catalog/ +[justfile]: https://github.com/WordPress/openverse/blob/main/catalog/justfile +[dockercompose]: + https://github.com/WordPress/openverse/blob/main/docker-compose.yml +[cc_airflow]: https://github.com/WordPress/openverse/tree/main/catalog ## Directory Structure @@ -291,13 +288,6 @@ previous team members @ryanmerkley, @janetpkr, @lizadaly, @sebworks, @pa-w, along with their [community of volunteers](https://opensource.creativecommons.org/community/community-team/). -## License - -- [`LICENSE`](LICENSE) (Expat/[MIT][mit] License) - -[mit]: - http://www.opensource.org/licenses/MIT - "The MIT License | Open Source Initiative" [wp_slack]: https://make.wordpress.org/chat/ [cc]: https://creativecommons.org [cc_community]: https://opensource.creativecommons.org/community/community-team/