From 626ec409db86f159158a616a6e28fddc12be1a7c Mon Sep 17 00:00:00 2001 From: Christian Grothoff Date: Tue, 18 Apr 2023 10:01:38 +0200 Subject: add DD 42 to index --- checklist-release.rst | 24 +++++----- design-documents/033-synchetic-wallet-errors.rst | 57 ------------------------ design-documents/042-synthetic-wallet-errors.rst | 57 ++++++++++++++++++++++++ design-documents/index.rst | 1 + 4 files changed, 70 insertions(+), 69 deletions(-) delete mode 100644 design-documents/033-synchetic-wallet-errors.rst create mode 100644 design-documents/042-synthetic-wallet-errors.rst diff --git a/checklist-release.rst b/checklist-release.rst index 33bfd614..a9008729 100644 --- a/checklist-release.rst +++ b/checklist-release.rst @@ -20,8 +20,8 @@ For exchange: - |check| upgrade 'demo.taler.net' - |check| run :doc:`demo upgrade checklist ` - |check| tag repo. -- |check| use deployment.git/packaging/*-docker/ to build Debian and Ubuntu packages -- |check| upload packages to deb.taler.net/ (note: only Florian/Christian can sign) +- |check| use 'deployment.git/packaging/\*-docker/' to build Debian and Ubuntu packages +- |check| upload packages to 'deb.taler.net' (note: only Florian/Christian can sign) - |check| change 'demo.taler.net' deployment to use new tag. - |check| Upload triplet to ftp-upload.gnu.org/incoming/ftp or /incoming/alpha @@ -39,8 +39,8 @@ For merchant (C backend): - |check| upgrade 'demo.taler.net' - |check| run :doc:`demo upgrade checklist ` - |check| tag repo. -- |check| use deployment.git/packaging/*-docker/ to build Debian and Ubuntu packages -- |check| upload packages to deb.taler.net/ (note: only Florian/Christian can sign) +- |check| use 'deployment.git/packaging/\*-docker/' to build Debian and Ubuntu packages +- |check| upload packages to 'deb.taler.net' (note: only Florian/Christian can sign) - |check| change 'demo.taler.net' deployment to use new tag. - |check| Upload triplet to ftp-upload.gnu.org/incoming/ftp or /incoming/alpha @@ -57,8 +57,8 @@ For sync: - |check| upgrade 'demo.taler.net' - |check| run :doc:`demo upgrade checklist ` - |check| tag repo. -- |check| use deployment.git/packaging/*-docker/ to build Debian and Ubuntu packages -- |check| upload packages to deb.taler.net/ (note: only Florian/Christian can sign) +- |check| use 'deployment.git/packaging/\*-docker/' to build Debian and Ubuntu packages +- |check| upload packages to 'deb.taler.net' (note: only Florian/Christian can sign) - |check| change 'demo.taler.net' deployment to use new tag. - |check| Upload triplet to ftp-upload.gnu.org/incoming/ftp or /incoming/alpha @@ -69,8 +69,8 @@ For taler-mdb: - |check| Change version number in configure.ac. - |check| make dist for release. - |check| tag repo. -- |check| use deployment.git/packaging/*-docker/ to build Debian and Ubuntu packages -- |check| upload packages to deb.taler.net/ (note: only Florian/Christian can sign) +- |check| use 'deployment.git/packaging/\*-docker/' to build Debian and Ubuntu packages +- |check| upload packages to 'deb.taler.net' (note: only Florian/Christian can sign) - |check| Upload triplet to ftp-upload.gnu.org/incoming/ftp or /incoming/alpha For taler-twister: @@ -97,8 +97,8 @@ For libeufin: - |check| make dist for release. - |check| verify dist builds from source - |check| tag repo. -- |check| use deployment.git/packaging/*-docker/ to build Debian and Ubuntu packages -- |check| upload packages to deb.taler.net/ (note: only Florian/Christian can sign) +- |check| use 'deployment.git/packaging/\*-docker/' to build Debian and Ubuntu packages +- |check| upload packages to 'deb.taler.net' (note: only Florian/Christian can sign) - |check| change 'demo.taler.net' deployment to use new tag. - |check| Upload triplet to ftp-upload.gnu.org/incoming/ftp or /incoming/alpha @@ -115,8 +115,8 @@ Wallet-core: - |check| make dist for release. - |check| verify dist builds from source - |check| tag repo. -- |check| use deployment.git/packaging/*-docker/ to build Debian and Ubuntu packages -- |check| upload packages to deb.taler.net/ (note: only Florian/Christian can sign) +- |check| use 'deployment.git/packaging/\*-docker/' to build Debian and Ubuntu packages +- |check| upload packages to 'deb.taler.net' (note: only Florian/Christian can sign) - |check| change 'demo.taler.net' deployment to use new tag. - |check| Upload triplet to ftp-upload.gnu.org/incoming/ftp or /incoming/alpha diff --git a/design-documents/033-synchetic-wallet-errors.rst b/design-documents/033-synchetic-wallet-errors.rst deleted file mode 100644 index 962e2dc3..00000000 --- a/design-documents/033-synchetic-wallet-errors.rst +++ /dev/null @@ -1,57 +0,0 @@ -Design Doc 033: Dev Experiments -############################### - -Summary -======= - -This design document defines new ``taler://`` URIs to cause synthetic errors -or special states in the wallet that can then be rendered by the UI. - -Motivation -========== - -UIs need to handle various (error-) states and responses of wallet-core. It's -not easy to cover all of these states and responses manually. Some of them are -hard to reach or simulate without an elaborate test setup. - -Requirements -============ - -The implementation of synthetic errors should be as separate from production -code as possible, to avoid making the normal code paths unreadable. - - -Proposed Solution -================= - -Special taler:// URIs ---------------------- - -* ``taler://dev-experiment/$STATE_ID`` -* ``taler://pay/...?dev-experiment=`` - -Special http(s):// URIs ------------------------ - -* ``http(s)://*.dev-experiment.taler.net/`` - - * URLs for this subdomain are handled specially by the - wallet's HTTP layer and return fixed / mocked responses - instead of making real requests. - - -List of experiments -------------------- - - - -Alternatives -============ - -Drawbacks -========= - -Discussion / Q&A -================ - -(This should be filled in with results from discussions on mailing lists / personal communication.) diff --git a/design-documents/042-synthetic-wallet-errors.rst b/design-documents/042-synthetic-wallet-errors.rst new file mode 100644 index 00000000..962e2dc3 --- /dev/null +++ b/design-documents/042-synthetic-wallet-errors.rst @@ -0,0 +1,57 @@ +Design Doc 033: Dev Experiments +############################### + +Summary +======= + +This design document defines new ``taler://`` URIs to cause synthetic errors +or special states in the wallet that can then be rendered by the UI. + +Motivation +========== + +UIs need to handle various (error-) states and responses of wallet-core. It's +not easy to cover all of these states and responses manually. Some of them are +hard to reach or simulate without an elaborate test setup. + +Requirements +============ + +The implementation of synthetic errors should be as separate from production +code as possible, to avoid making the normal code paths unreadable. + + +Proposed Solution +================= + +Special taler:// URIs +--------------------- + +* ``taler://dev-experiment/$STATE_ID`` +* ``taler://pay/...?dev-experiment=`` + +Special http(s):// URIs +----------------------- + +* ``http(s)://*.dev-experiment.taler.net/`` + + * URLs for this subdomain are handled specially by the + wallet's HTTP layer and return fixed / mocked responses + instead of making real requests. + + +List of experiments +------------------- + + + +Alternatives +============ + +Drawbacks +========= + +Discussion / Q&A +================ + +(This should be filled in with results from discussions on mailing lists / personal communication.) diff --git a/design-documents/index.rst b/design-documents/index.rst index aee3af42..fd2ca7b8 100644 --- a/design-documents/index.rst +++ b/design-documents/index.rst @@ -50,4 +50,5 @@ and protocol. 039-taler-browser-integration.rst 040-distro-packaging.rst 041-wallet-balance-amount-definitions.rst + 042-synthetic-wallet-errors.rst 999-template -- cgit v1.2.3