/devcenter

Primary LanguageHTMLMIT LicenseMIT

Bitrise DevCenter

Feel free to edit any page & to send us a Pull Request!!

Note: you can edit the pages on GitHub directly, you don't even have to git clone the repository. Just select the file on GitHub and click the pencil/edit icon, which will open the GitHub editor for the file. Example for this page.

If you don't want to edit the page on GitHub, feel free to contact us, and we'll do the change for you!

Category notes

  • tips-and-tricks vs tutorials : tutorials have to include a complete guide as much as possible, e.g. steps to register the repository/app. tips-and-tricks is short, only describes the thing it wants to achieve. Later can be moved into tutorial, by adding more info.

API docs - edit the .gg files!!

API responses and the whole .md files are auto-generated; please edit the .md.gg template files instead of editing the .md directly!

To add a new endpoint documentation section:

  • open the docs/api/vX.md.gg template file
  • add the endpoint section, following the other endpoints' doc structure
  • add the example endpoint call to the _scripts/gen_api_docs_gotgen_config.go file (using the api-demo bitrise.io user to locate the right example URL, e.g. if it have to include a repo/build/... slug)
  • use that in the example response section of the endpoint ({{ (var "/URL-PATH").HTTPMETHOD }})
  • and finally, run: bitrise run generate-api-docs to generate the .md from the .md.gg