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

final, update readme #1544

Merged
merged 1 commit into from
Dec 27, 2023
Merged
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
33 changes: 4 additions & 29 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,34 +1,9 @@
# BigCommerce API Specifications

This repo contains the OpenAPI Specifications (OAS) and JSON schema that form the human-readable [BigCommerce REST API Reference](https://developer.bigcommerce.com/docs/api).
**As of December 27, 2023, you can find all the public BigCommerce DevDocs at [https://github.com/bigcommerce/docs](https://github.com/bigcommerce/docs)!**

As of August 22, 2022, all API specification files are in OAS 3+ format. We also made significant changes to this repo in March 2023. Please update your fork to ensure you're working with the newest source files.
This repository is archived and read only. The final commit has been tagged.

## Contributing
If you maintain API clients, the new [bigcommerce/docs](https://github.com/bigcommerce/docs) repo is now your source for the most up-to-date API specifications.

If you're interested in contributing, see [CONTRIBUTING.md](CONTRIBUTING.md).

## Directory structure

```shell
.
├── .github/ # github config
└── workflows/ # workflows to lint pull requests, etc.
├── .idea/ # directory ignored by git - use for yourself
├── models/ # yml schema for various objects
├── email_templates/ # email template schemas
├── webhooks/ # webhooks schemas
└── json2schema.py # script to convert json to yml
├── reference/ # openapi specification files
├── catalog/ # catalog OAS API reference
├── payments/ # payments OAS API reference
└── ... # other OAS API reference
├── .eslintrc.json # config for MDX linter
├── .gitignore # gitignore
├── .spectral.yaml # config for OAS linter
├── CONTRIBUTING # guidelines for contribution
├── package-lock.json
├── package.json
├── pull_request_template.md # template for most pull requests
└── README
```
This consolidation lets the BigCommerce DX team offer a more streamlined developer experience. [issues](https://github.com/bigcommerce/docs/issues), [discussions](https://github.com/bigcommerce/docs/discussions), and [pull requests](https://github.com/bigcommerce/docs/pulls) at [bigcommerce/docs](https://github.com/bigcommerce/docs)!
Loading