diff --git a/docs/docs-manifest.json b/docs/docs-manifest.json index a7cffde1f07..8b72e5cb0f8 100644 --- a/docs/docs-manifest.json +++ b/docs/docs-manifest.json @@ -526,19 +526,10 @@ "menu_title": "Developer tools", "tags": "reference", "edit_url": "https://github.com/woocommerce/woocommerce/edit/trunk/docs/getting-started/developer-tools.md", - "hash": "0c63cb8213a7bb64295f7321afc9fce5c8e12c3b860e7bb885fe66ac7a71d661", + "hash": "ef24e32109d66f96a990fea7a5eb32f9e0b98ae7ca766dcae12244449956997b", "url": "https://raw.githubusercontent.com/woocommerce/woocommerce/trunk/docs/getting-started/developer-tools.md", "id": "2ed3659ae0153c8fb3252c417bb0eb43ea60f862" }, - { - "post_title": "WooCommerce developer resources", - "menu_title": "Developer resources", - "tags": "reference", - "edit_url": "https://github.com/woocommerce/woocommerce/edit/trunk/docs/getting-started/developer-resources.md", - "hash": "ec2c30bd0d73eb26e636da9d9d3468eb3bc453213099edcc73468a74407e600c", - "url": "https://raw.githubusercontent.com/woocommerce/woocommerce/trunk/docs/getting-started/developer-resources.md", - "id": "77008656b040d376b7cea7b3c7cc8860c6aec70e" - }, { "post_title": "Resources for debugging", "menu_title": "Debugging", @@ -561,6 +552,15 @@ "links": { "./woocommerce-endpoints.md": "31a11f74bcd9f21f97cd4c6c719240b3d84e40f4" } + }, + { + "post_title": "Contributing to WooCommerce Core", + "menu_title": "Contribute to WooCommerce Core", + "tags": "reference", + "edit_url": "https://github.com/woocommerce/woocommerce/edit/trunk/docs/getting-started/contributing-to-core-and-marketplace.md", + "hash": "b9c53ffb82b83dfe54c95c85a9f7c0127942087804f0490a2abfccb993ad3e2c", + "url": "https://raw.githubusercontent.com/woocommerce/woocommerce/trunk/docs/getting-started/contributing-to-core-and-marketplace.md", + "id": "198a4d4a506d464737c356f86684676ad4a0c27b" } ], "categories": [] @@ -1211,5 +1211,5 @@ "categories": [] } ], - "hash": "514bc14b1dd1c31a5aa6e3f47fe9fb61fb9dd28db4e475c2397f5f409ce06cf0" + "hash": "f1bb14ff2aa8c9be096365b78633ace4696f6314cd298e0cb57104a73b507fac" } \ No newline at end of file diff --git a/docs/getting-started/contributing-to-core-and-marketplace.md b/docs/getting-started/contributing-to-core-and-marketplace.md new file mode 100644 index 00000000000..bf801075967 --- /dev/null +++ b/docs/getting-started/contributing-to-core-and-marketplace.md @@ -0,0 +1,19 @@ +--- +post_title: Contributing to WooCommerce Core +menu_title: Contribute to WooCommerce Core +tags: reference +--- + +Whether you are a seasoned WordPress developer, or a WooCommerce developer looking to get more involved with our open source ecosystem, please check out our guidelines on GitHub and start contributing! + +### [Contributor Guidelines](https://github.com/woocommerce/woocommerce/blob/trunk/.github/CONTRIBUTING.md) + +If you have ever wanted to contribute to the WooCommerce platform as a developer please read our guidelines for contribution first. + +### [Contribution Environment Set-Up](https://github.com/woocommerce/woocommerce/tree/trunk) + +Visit the WooCommerce monorepo on GitHub to learn the first steps to environment set up and platform contribution expectations. + +### [Marketplace Contribution Guidelines](https://woo.com/document/marketplace-overview/) + +Are you hoping to sell your extension in the [Woo Marketplace](https://woo.com/marketplace/)? Read our guidelines to make sure your extension is marketplace-ready. diff --git a/docs/getting-started/developer-resources.md b/docs/getting-started/developer-resources.md deleted file mode 100644 index ef4fef563a0..00000000000 --- a/docs/getting-started/developer-resources.md +++ /dev/null @@ -1,102 +0,0 @@ ---- -post_title: WooCommerce developer resources -menu_title: Developer resources -tags: reference ---- - -This guide is a great starting point for WooCommerce development. From setting up your first online store to diving deep into advanced features, you'll find what you need here. New to WooCommerce? Start with the basics. Experienced and looking for specific documentation or community discussions? We've got that covered too. Navigate through the sections below to find the resources tailored for you. - -## Getting Started - -There are a few different ways you might want to get started utilizing WooCommerce. Choose a path below to start developing based on your code comfort level! - -### [Installing and setting up WooCommerce](https://woo.com/document/build-online-store/) - -If you're brand new to Woo, this guide will show you How to build an online store on WooCommerce. This is where you can learn the ins and outs of how WooCommerce works before you start developing. - -### [Extension Development Quick Start](https://github.com/woocommerce/woocommerce/tree/trunk/packages/js/create-woo-extension) - -This no-configuration quick-start package will scaffold a local copy of an extension template for you. Just open up your terminal and follow the steps in GitHub. - -### [Building your first extension](/extension-development/building-your-first-extension.md) - -This guide will have you building your first extension with best practices and helpful tips. - -### [Marketplace Contribution Guidelines](https://woo.com/document/marketplace-overview/) - -Are you hoping to sell your extension in the [Woo Marketplace](https://woo.com/marketplace/)? Read our guidelines to make sure your extension is marketplace-ready. - -### [Contributor Guidelines](https://github.com/woocommerce/woocommerce/blob/trunk/.github/CONTRIBUTING.md) - -If you've ever wanted to contribute to the WooCommerce platform as a developer please read our guidelines for contribution first. - -### [Contribution Environment Set-Up](https://github.com/woocommerce/woocommerce/tree/trunk) - -Visit the WooCommerce home repository on GitHub to learn the first steps to environment set up and platform contribution expectations. - -### [Developer tools](docs/getting-started/developer-tools.md) - -Check out our guide to learn more about developer tools, libraries, and utilities. - ---- - - -## API & Reference Docs - -The resources below contain low-level documentation about features, libraries, extensions, and other pieces of WooCommerce architecture. Use them as a reference when building extensions or integrating with WooCommerce. - -## [REST API](https://woocommerce.github.io/woocommerce-rest-api-docs/) - -The WooCommerce REST API lets you create, read, update, and delete WooCommerce data using HTTP requests, so you can integrate external applications with WooCommerce and build extensions that make use of asynchronous UI frameworks such as React. - -### [Core API](https://woo.com/wc-apidocs/index.html) - -The WooCommerce Core API code reference contains information about packages and classes that make up WooCommerce's core functionality. - -### [Store API](https://github.com/woocommerce/woocommerce-blocks/tree/trunk/src/StoreApi) - -The Store API provides public Rest API endpoints for the development of customer-facing cart, checkout, and product functionality. It follows many of the patterns used in the [WordPress REST API](https://developer.wordpress.org/rest-api/key-concepts/). - -### [WooCommerce Blocks](https://github.com/woocommerce/woocommerce-gutenberg-products-block/#documentation) - -WooCommerce Blocks give you the ability to integrate WooCommerce with Gutenberg. Use the documentation and resources here as a starting point for developing new block types for WooCommerce. - -### [Core Action and Filter Hooks](https://woo.com/wc-apidocs/hooks/hooks.html) - -This contains an index of hooks found across all template files, functions, shortcodes, widgets, data stores, and core classes. You can use these hooks to extend the core WooCommerce platform by introducing custom behavior or modifying data that WooCommerce passes around. - -### [Shortcodes Included with WooCommerce](https://woo.com/document/woocommerce-shortcodes/) - -While WooCommerce Blocks are now the easiest and most flexible way to display your products on posts and pages, WooCommerce still comes with several shortcodes to insert content. - -## GitHub Repositories - -### [WooCommerce on GitHub](https://github.com/woocommerce) - -This is the official WooCommerce organization on GitHub. Here you'll find the majority of development work that happens on open source projects that the WooCommerce team maintains. - -### [Automattic on GitHub](https://github.com/automattic) - -This is the official Automattic organization on GitHub. It is where you'll find the majority of development work that happens on open source projects that the Automattic team maintains. - -### [WordPress on GitHub](https://github.com/wordpress) - -This is the official WordPress organization on GitHub -- a go-to source for the development work that happens on open source projects that the WordPress community maintains. - -## Ecosystem Resources - -### [WordPress Developer Resources](https://developer.wordpress.org/) - -All the resources you need for developing with WordPress. If you're not familiar with the WordPress development ecosystem, this is a great place to start. - -### [WooCommerce Community Slack](https://woo.com/community-slack) - -Join our community on Slack. We hold regular sessions where we share information and field questions, but you can also connect with other developers to share challenges and ask questions. - -### [WooCommerce Community Forum](https://wordpress.org/support/plugin/woocommerce/) - -Use this forum to ask questions about WooCommerce. Our WooCommerce Happiness Engineers frequent this forum to answer questions, but there is also a wealth of knowledge that has been captured in these threads over the years. - -### [WooCommerce on Reddit](https://www.reddit.com/r/woocommerce/) - -Visit the WooCommerce subreddit to ask questions and share tips with other developers. diff --git a/docs/getting-started/developer-tools.md b/docs/getting-started/developer-tools.md index add42d42b1e..dda89fb0cd8 100644 --- a/docs/getting-started/developer-tools.md +++ b/docs/getting-started/developer-tools.md @@ -22,10 +22,6 @@ This command-line tool lets you easily set up a local WordPress environment for This is an [ESLint](https://eslint.org/) plugin including configurations and custom rules for WooCommerce development. -### [e2e-environment](https://www.npmjs.com/package/@woocommerce/e2e-environment) - -This is a reusable and extensible end-to-end testing environment for WooCommerce extensions. Additionally, it contains several files to serve as the base for a Docker container and Travis CI setup. - ### [WordPress Scripts](https://www.npmjs.com/package/@wordpress/scripts) This is a collection of reusable scripts tailored for WordPress development.