github

github

The github option allows you associate your specification with a repository on GitHub.

It takes either a string (URL to your repo or a string of format: org/repo) or an object with the following properties:

• repoURL - the URL for the repository (e.g., https://github.com/w3c/browser-payment-api)
• branch - optional, the branch you are using for GitHub pages. It defaults to "gh-pages".

This automatically generates:

• githubAPI
• issueBase
• edDraftURI

It adds "Feedback:" to the header of the document, with the appropriate links to your GitHub repository.

This is normally what you want:

var respecConfig = {
  github: "w3c/browser-payment-api",
};

var respecConfig = {
  github: "https://github.com/w3c/browser-payment-api",
};

This example shows a repository whose specs are being served from a "public-docs" branch.

var respecConfig = {
  github: {
    repoURL: "https://github.com/w3c/browser-payment-api",
    branch: "public-docs", // alternative branch
  },
};