Skip to content

Commit

Permalink
Merge branch 'main' into DEVDOCS-5797-pci
Browse files Browse the repository at this point in the history
  • Loading branch information
bc-andreadao committed Sep 19, 2024
2 parents 8f8ac19 + 553116f commit b5bcc91
Show file tree
Hide file tree
Showing 801 changed files with 130,904 additions and 28,536 deletions.
31 changes: 31 additions & 0 deletions .github/ISSUE_TEMPLATE/bug-report.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,31 @@
---
name: "\U0001F41E\U0001F4DD Bug report"
about: You've identified a bug in our docs.
title: "[x] is not working when I [y]"
labels: ''
assignees: ''

---

We really appreciate the help making our docs better. Every issue helps!

**Describe the bug**
A clear and concise description of what the bug is.

**To Reproduce**
Steps to reproduce the behavior:
1. Go to '...'
2. Click on '....'
3. Scroll down to '....'
4. See error

Please link to a repo that can be used to reproduce this issue, if possible. It'll help fix the bug faster.

**Expected behavior**
A clear and concise description of the bug you've identified.

**Screenshots**
If applicable, add screenshots to help explain the bug you've identified.

**Additional context**
Add any other context about the problem here.
18 changes: 18 additions & 0 deletions .github/ISSUE_TEMPLATE/config.yml
Original file line number Diff line number Diff line change
@@ -0,0 +1,18 @@
blank_issues_enabled: false
contact_links:
- name: Have questions?
url: https://developer.bigcommerce.com/docs/build
about:
Explore the dev docs.
- name: Feature request
url: https://github.com/bigcommerce/docs/discussions/new?category=ideas-feature-requests
about:
Join us in Discussions to share your idea on improving our docs. Thanks for your contribution!
- name: Need help with our docs?
url: https://support.bigcommerce.com/s/contact
about:
To report an outage or greater platform issue, contact our Technical Support team. If you're a partner, please do so via your Partner Portal.
- name: 💙 Join the BigCommerceDevs community
url: https://developer.bigcommerce.com/community
about: Connect with other devs building on BigCommerce!

6 changes: 6 additions & 0 deletions .github/actions/retext-style-guide/action.yml
Original file line number Diff line number Diff line change
Expand Up @@ -28,6 +28,12 @@ inputs:
reviewdog_flags:
description: 'Additional reviewdog flags'
default: ''
before_commit:
description: 'Commit SHA before you triggered the event'
default: '${{ github.event.before }}'
after_commit:
description: 'Commit SHA after you triggered the event'
default: '${{ github.sha }}'
runs:
using: 'docker'
image: 'Dockerfile'
Expand Down
3 changes: 2 additions & 1 deletion .github/actions/retext-style-guide/entrypoint.sh
Original file line number Diff line number Diff line change
Expand Up @@ -17,4 +17,5 @@ find ${GITHUB_WORKSPACE} -type f -name '*.mdx' -exec quality-docs {} + \
-fail-on-error="${INPUT_FAIL_ON_ERROR}" \
-level="${INPUT_LEVEL}" \
${INPUT_REVIEWDOG_FLAGS} \
-tee
-tee \
-diff="git diff --unified=0 ${INPUT_BEFORE_COMMIT} ${INPUT_AFTER_COMMIT}"
21 changes: 13 additions & 8 deletions .github/workflows/deploy.yml
Original file line number Diff line number Diff line change
@@ -1,4 +1,4 @@
name: Deploy
name: Rebuild Production Dev Center

on:
push:
Expand All @@ -9,11 +9,16 @@ on:
jobs:
build:
runs-on: ubuntu-latest

steps:
- name: Checkout code
uses: actions/checkout@v2

- name: Trigger Vercel Deploy Hook
steps:
- name: Trigger CircleCI Build
run: |
curl -X POST ${{ secrets.VERCEL_DEPLOY_HOOK_URL }}?buildCache=false
curl --location 'https://circleci.com/api/v2/project/gh/bigcommerce/developer-center/pipeline' \
--header 'Circle-Token: ${{ secrets.CIRCLECI_TOKEN }}' \
--header 'content-type: application/json' \
--data '{
"branch": "main",
"parameters": {
"build_environment": "production",
"github_triggering_actor": "${{ github.actor }}"
}
}'
8 changes: 7 additions & 1 deletion .github/workflows/retext-style-guide.yml
Original file line number Diff line number Diff line change
Expand Up @@ -5,9 +5,15 @@ jobs:
name: runner / retext-style-guide
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@v3
- name: Checkout code
uses: actions/checkout@v4
with:
fetch-depth: 0

- uses: ./.github/actions/retext-style-guide
with:
github_token: ${{ secrets.GITHUB_TOKEN }}
reporter: github-pr-review
filter_mode: added
before_commit: ${{ github.event.before }}
after_commit: ${{ github.sha }}
131 changes: 41 additions & 90 deletions .spectral.yaml
Original file line number Diff line number Diff line change
@@ -1,93 +1,44 @@
extends: spectral:oas
rules:
info-contact: off
oas3-unused-component: off
oas2-unused-definition: off
except:
'reference/tax_provider.yml':
- oas3-schema
'reference/carts.v3.yml':
- oas2-oneOf
- oas2-valid-schema-example
- operation-tag-defined
'reference/catalog.v3.yml':
- oas2-operation-security-defined
- oas3-schema
- oas2-schema
- oas2-valid-media-example
- oas2-valid-schema-example
'reference/channels.v3.yml':
- oas3-schema
- oas3-valid-media-example
'reference/current_customer.yml':
- operation-success-response
'reference/custom-template-associations.v3.yml':
- openapi-tags
- operation-tag-defined
'reference/customer_login.yml':
- operation-success-response
'reference/email_templates.v3.yml':
- oas3-schema
'reference/geography.v2.yml':
- oas2-valid-media-example
'reference/orders.v2.oas2.yml':
- oas3-valid-schema-example
- oas3-valid-media-example
- oas3-schema
'reference/orders.v3.yml':
- oas2-valid-schema-example
- oas2-valid-media-example
- oas2-anyOf
'reference/settings.v3.yml':
- oas3-valid-media-example
'reference/sites.v3.yml':
- oas2-valid-media-example
'reference/store_information.v2.yml':
- oas2-valid-media-example
- oas2-valid-schema-example
'reference/themes.v3.yml':
- oas3-schema
'reference/webhooks.v3.yml':
- oas3-valid-media-example
'carts.v3.yml':
- oas2-oneOf
- oas2-valid-schema-example
'catalog.v3.yml':
- oas2-operation-security-defined
- oas3-schema
- oas2-schema
- oas2-valid-media-example
- oas2-valid-schema-example
'channels.v3.yml':
- oas3-schema
- oas3-valid-media-example
'current_customer.yml':
- operation-success-response
'customer_login.yml':
- operation-success-response
'email_templates.v3.yml':
- oas3-schema
'geography.v2.yml':
- oas2-valid-media-example
'orders.v2.oas2.yml':
- oas3-valid-schema-example
- oas3-valid-media-example
- oas3-schema
'orders.v3.yml':
- oas2-valid-schema-example
- oas2-valid-media-example
- oas2-anyOf
'settings.v3.yml':
- oas3-valid-media-example
'sites.v3.yml':
- oas2-valid-media-example
'store_information.v2.yml':
- oas2-valid-media-example
- oas2-valid-schema-example
'themes.v3.yml':
- oas3-schema
'webhooks.v3.yml':
- oas3-valid-media-example
'pages.v3.yml':
- oas3-valid-media-example
- oas3-valid-schema-example
properties-type-object:
description: "type: object must have a properties sibling."
given: "$..[?(@ && @.type == 'object')]"
severity: error
# must not be resolved because $ref-defined objects shall have its type
# defined in the referenced schema, not the referencing field (and $ref
# must be the only property, anyway)
resolved: false
# type field must be defined and contain the value object
then:
- field: "properties"
function: "truthy"
items-type-array:
description: "type: array must have an items sibling."
given: "$..[?(@ && @.type == 'array')]"
severity: error
# must not be resolved because $ref-defined objects shall have its type
# defined in the referenced schema, not the referencing field (and $ref
# must be the only property, anyway)
resolved: false
# type field must be defined and contain the value object
then:
- field: "items"
function: "truthy"
type-object-properties:
description: "Objects with properties must have type: object."
given: "$..[?(@ && @.properties)]"
severity: error
# must not be resolved because $ref-defined objects shall have its type
# defined in the referenced schema, not the referencing field (and $ref
# must be the only property, anyway)
resolved: false
# type field must be defined and contain the value object
then:
- field: "type"
function: defined
- field: "type"
function: enumeration
functionOptions:
values:
- object
55 changes: 43 additions & 12 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,33 +1,53 @@
# BigCommerce Public Developer Documentation
<p align="center">
<img alt="bcdevs logo" src="./assets/images/bcdevs-logo.png" width="100px" />
<h1 align="center">BigCommerce developer documentation</h1>
</p>

This repo is the source of truth for the public, open source BigCommerce DevDocs and API reference at [developer.bigcommerce.com](https://developer.bigcommerce.com). It consists of **Markdown React (.mdx)**, **OpenAPI Specification (.yml)**, and **JSON Schema (.json and .yml)** files.
You've found the BigCommerce documentation GitHub repository, which contains the public content for the [BigCommerce Developer Center](https://developer.bigcommerce.com/docs).

This repo is the source of truth for our public, open source documentation and API reference at [developer.bigcommerce.com](https://developer.bigcommerce.com). It consists of **Markdown React (.mdx)**, **OpenAPI Specification (.yml)**, and **JSON Schema (.json and .yml)** files.

The BigCommerce DX team maintains these open source docs; we welcome your [issues](https://github.com/bigcommerce/docs/issues), [discussions](https://github.com/bigcommerce/docs/discussions), and [pull requests](https://github.com/bigcommerce/docs/pulls)!

---

## Contributing
Thanks for your interest in contributing to our documentation! Below are a few quick ways to get started:

### 👉 To make a change
Here are some quick links to our [Contribution](/CONTRIBUTING.md) guide:

- [Making a Quick Edit](/CONTRIBUTING.md#making-a-quick-edit)
- [Editing Locally](/CONTRIBUTING.md#editing-locally)
- [Commit Messages](/CONTRIBUTING.md/cod#commit-messages)
- [Style Guides](/CONTRIBUTING.md#style-guides)
- [Contributing to Other Projects](/CONTRIBUTING.md#contributing-to-other-projects)

### 👉 To discuss something
- Start a [Discussion](https://github.com/bigcommerce/docs/discussions). Our DevDocs team monitors GitHub Discussions regularly.

If you're interested in contributing, see our [Contribution Guide](CONTRIBUTING.md) and [Code of Conduct](CODE_OF_CONDUCT.md).
### 👉 To report a bug or an issue you've encountered
- Open a new [Issue](https://github.com/bigcommerce/docs/issues). Our DevDocs team monitors GitHub Issues regularly.

## History
<br/>

On December 27, 2023, the following public documentation repositories were deprecated, and all documentation moved into this repository. We retained the `git` history of each document using the `--allow-unrelated-histories` flag. The following repositories are now read-only:
*For more information, see our [Contribution Guidelines](./CONTRIBUTING.md) and [Code of conduct](./CODE_OF_CONDUCT.md).*

* `https://github.com/bigcommerce/api-specs`
* `https://github.com/bigcommerce/dev-docs`
* `https://github.com/bigcommerce/theme-context-object-schemas`
---

### API specifications
## API specifications

If you maintain API clients, this repository is your source for the most up-to-date public API specifications.

Please keep your fork up to date to ensure you're working with the newest source files.
Always update your fork to ensure you're working with the newest source files.

Significant dates include the following:
<!-- Significant dates include the following:
* As of August 22, 2022, all API specification files are in OAS 3+ format.
* In March 2023, we made significant changes to support a new OAS parser at [developer.bigcommerce.com](https://developer.bigcommerce.com).
* In May 2023, we subdivided both the Catalog and Payments API specifications into multiple files.
* On December 27, 2023, all public docs moved into the [bigcommerce/docs](https://github.com/bigcommerce/docs) repo.
* On December 27, 2023, all public docs moved into the [bigcommerce/docs](https://github.com/bigcommerce/docs) repo. -->


## Directory structure

Expand Down Expand Up @@ -72,4 +92,15 @@ Significant dates include the following:
├── package.json
├── pull_request_template.md # template for most pull requests
└── README.md

```

## Archived docs
View our archived documentation [here](/archive/).

---
## Our developer channels:
* [Join our Developer Slack space](https://developer.bigcommerce.com/slack)
* [Read or contribute to our Resource Hub](https://developer.bigcommerce.com/resource-hub)
* [Follow us on X (Twitter) @BigCommerceDevs](https://twitter.com/BigCommerceDevs)
* [Follow the BigCommerce Developers Linkedin](https://www.linkedin.com/showcase/bigcommercedevs/)
Loading

0 comments on commit b5bcc91

Please sign in to comment.