Skip to content

Latest commit

 

History

History
43 lines (27 loc) · 1.17 KB

README.md

File metadata and controls

43 lines (27 loc) · 1.17 KB
Raw

api.dart.dev server

An App Engine server that fronts a Google Cloud Storage repository of Dart API docs.

See LICENSE.

Link structure

First, read how dartdoc structures links.

The api.dart.dev server expand some structure in the links from dartdoc.

/             ==> /stable
/stable       ==> /<latest-stable-version>/index.html
/beta         ==> /latest-beta-version>/index.html
/dev          ==> /latest-dev-version>/index.html
/main         ==> /<latest-bleeding-edge-version>/index.html

/stable/dart-async/Future-class.html ==> /<latest-stable-version>/dart-async/Future-class.html
(same for beta, dev, and main)

Deployment

  1. Install the Google Cloud SDK.

  2. Run gcloud auth login

  3. Run gcloud config set app/promote_by_default false to avoid accidentally deploying a test version.

  4. Run gcloud config set project dartlang-api

  5. Run gcloud app deploy -v name-of-new-version server/app.yaml and test

  6. Run gcloud app deploy -v name-of-new-version --promote server/app.yaml to make this version the default