Commit Graph

1098 Commits

Author SHA1 Message Date
Moritz Kiefer
71fc3529e6
Improve --help ux for Canton sandbox (#12990)
* Improve --help ux for Canton sandbox

fixes #12985

changelog_begin
changelog_end

* .
2022-02-21 10:33:50 +01:00
Stephen Compall
fceb9c1118
document Java 11 is needed; small release instruction problems found today (#12978)
In docs:

* doc that we require Java 11, not 8

In release instructions:

* mention everywhere that all-lowercase party entries should be made

* wrong line number for variable go-to-defn check

CHANGELOG_BEGIN
CHANGELOG_END
2022-02-16 20:38:31 +00:00
Jennifer Whyte
bdfbb0d928
Update bg color on docs sections (#12975)
Adds a background color to the floating section. Previously it was transparent and caused readability issues.

CHANGELOG_BEGIN
CHANGELOG_END
2022-02-16 12:21:26 -05:00
mziolekda
f645641acf
Bump ledger api version to 2.0 (#12956)
CHANGELOG_BEGIN
Ledger API version 2.0
CHANGELOG_END
2022-02-16 11:55:49 +01:00
nicu-da
55fef9cf6a
[ledger-api] - Rename max deduplication time to max deduplication duration [KVL-1311] (#12939)
changelog_begin
ledger-api - rename ledger configuration max_deduplication_time to max_deduplication_duration
changelog_end
2022-02-15 21:14:26 +01:00
carrielaben-da
040c92f382
Getting Started Guide Update - First Draft (#12752)
* Update app-architecture.rst

* Update first-feature.rst

* Update index.rst

* Update installation.rst

* Update manual-download.rst

* Update path-variables.rst

* Revert "Update path-variables.rst"

This reverts commit 62f5554f2e.

* Revert "Update manual-download.rst"

This reverts commit e1cf0248a4.

* Revert "Update installation.rst"

This reverts commit ba229215ab.

* Revert "Update index.rst"

This reverts commit 052be7dc19.

* Revert "Update first-feature.rst"

This reverts commit 120d894ad6.

* Revert "Update app-architecture.rst"

This reverts commit 78ffa6d2c1.

* Getting Started Guide first draft updates

Changes to the individual pages of the Getting Started Guide

[CHANGELOG_BEGIN]
app-architecture.rst content and style edits
first-feature.rst style edits
index.rst style edits
installation.rst style edits
manual-download.rst style edits
path-variables.rst style edits
[CHANGELOG_END]

* Revert "Update path-variables.rst"

This reverts commit 62f5554f2e.

* Revert "Revert "Update path-variables.rst""

This reverts commit 674ca81999.

CHANGELOG_BEGIN
CHANGELOG_END

* Update docs/source/getting-started/index.rst

Accepting correction of type

[CHANGELOG_BEGIN]
"mke" to "make"
[CHANGELOG_END]

Co-authored-by: Moritz Kiefer <moritz.kiefer@purelyfunctional.org>

* Update docs/source/getting-started/installation.rst

Changing header separation line (?)

[CHANGELOG_BEGIN]
Accepted line 70 comment
CHANGELOG_END]

Co-authored-by: Moritz Kiefer <moritz.kiefer@purelyfunctional.org>

* Addressing reviewer comments for PR "Getting Started Guide Update - First Draft"

Addressing comments related to the text. Screenshot updates to follow.

[CHANGELOG_BEGIN]
Line 97: New user name requirements
Lines 105-106: Adjusted terminology
[CHANGELOG_END]

* Update first-feature.rst to address comments in the Getting Started Guide Update - First Draft PR

Addressing @cocreature 's feedback

[CHANGELOG_BEGIN]
Line 23: Removed redundant instruction.
Line 85: Tense issue.
[CHANGELOG_END]

* Update app-architecture.rst for PR Getting Started Guide Update - First Draft

Incorporating suggested changes

[CHANGELOG_BEGIN]
Line 54: Adjusted description of naming terminology and behavior
[CHANGELOG_END]

* GSG changes attempt 3

Addresses existing comments; checks for heading formatting; updated screenshots.

[CHANGELOG_BEGIN]
Addresses existing comments; checks for heading formatting; updated screenshots.
[CHANGELOG_END]

* Update docs/source/getting-started/installation.rst

Formatting fix
[CHANGELOG_BEGIN]
Formatting fix
[CHANGELOG_END]

Co-authored-by: Moritz Kiefer <moritz.kiefer@purelyfunctional.org>

* fix more formatting

changelog_begin
changelog_end

* Update docs/source/getting-started/index.rst

Further clarification of alias vs id
[CHANGELOG_BEGIN]
UI by their alias instead of their user id,
[CHANGELOG_END]

Co-authored-by: Moritz Kiefer <moritz.kiefer@purelyfunctional.org>

Co-authored-by: carrie-laben <91496516+carrie-laben@users.noreply.github.com>
Co-authored-by: Jennifer <jennifer.whyte@digitalasset.com>
Co-authored-by: Moritz Kiefer <moritz.kiefer@purelyfunctional.org>
2022-02-15 17:48:27 +00:00
Moritz Kiefer
6ed6ea36e8
Drop parties from daml templates (#12953)
Complements #12952 which drops it from create-daml-app by also
dropping it from the rest.

Couldn’t find any docs or other stuff that is broken by this.

changelog_begin
changelog_end
2022-02-15 17:21:32 +00:00
Jennifer Whyte
4df4db11e8
Add new toctrees in daml docs (#12880)
* Add toctrees in daml docs

CHANGELOG_BEGIN
CHANGELOG_END

* Update operating-daml.rst

Remove wrong link (ops/index>

CHANGELOG_BEGIN
CHANGELOG_END

* Making toc visible on new pages

Making toctrees visible so new pages aren't empty

* Update docs/source/building-applications.rst

Co-authored-by: Moritz Kiefer <moritz.kiefer@purelyfunctional.org>

* Fix underlines

CHANGELOG_BEGIN
CHANGELOG_END

* Fix missing from toctree messages

CHANGELOG_BEGIN
CHANGELOG_END

* Fix pdf docs

changelog_begin
changelog_end

Co-authored-by: Moritz Kiefer <moritz.kiefer@purelyfunctional.org>
2022-02-15 07:34:29 +00:00
Moritz Kiefer
8e32842f57
Switch docs for upgrade automation to Canton Sandbox (#12908)
changelog_begin
changelog_end
2022-02-14 14:08:32 +00:00
Moritz Kiefer
d6e6c568fe
Fold daml test-script under daml script --all (#12895)
I tried to keep the changes somewhat minimal and reuse what is already
there. I think there is a fair amount of cleanup we can do afterwards
but hopefully this way it’s easier to review.

fixes #12837

changelog_begin

- [Daml Script] `daml test-script` has been replaced by `daml script
  --all`. The option to spin up a ledger automatically has been
  removed and you always have to specify one.

changelog_end
2022-02-14 14:23:21 +01:00
Moritz Kiefer
a30c5c2ebc
Switch upgrade docs to Canton sandbox (#12904)
* Switch upgrade docs to Canton sandbox

Mainly requires explicitly allocating parties & users and dealing with
Navigator being annoying.

changelog_begin
changelog_end

* .

changelog_begin
changelog_end
2022-02-14 13:55:53 +01:00
mziolekda
d9d8083451
Remove references to pre-canton sandbox from documentation (#12888)
* Remove references to pre-canton sandbox from documentation

CHANGELOG_BEGIN
CHANGELOG_END

* address review comments
2022-02-11 13:57:44 +01:00
Kamil Bozek
9785101254
Remove references to the legacy error codes from docs (#12749)
CHANGELOG_BEGIN
CHANGELOG_END
2022-02-11 13:23:07 +01:00
mziolekda
42ff83d456
Remove daml on sql artifacts and docs (#12870)
* stop publishing daml on sql aka Daml Driver for PotgreSQL

CHANGELOG_BEGIN
Stop publishing Daml Driver for PostgreSQL
CHANGELOG_END
2022-02-10 18:01:18 +00:00
Raymond Roestenburg
0c08c1cb01
Create users in quickstart template. (#12868)
changelog_begin
changelog_end
2022-02-10 15:25:26 +01:00
Stefano Baghino
0fbf76599a
Restore comment about keeping Helm Chart docs in sync (#12862)
As noted by @garyverhaegen-da in https://github.com/digital-asset/daml/pull/12859#issuecomment-1034744480

Double checked that the comment syntax is used correctly and doesn't get
rendered on our docs.

changelog_begin
changelog_end
2022-02-10 10:58:04 +00:00
Stefano Baghino
1f247b0d40
Remove unnecessary comment from Helm Chart docs (#12859)
changelog_begin
changelog_end
2022-02-10 10:12:40 +00:00
Moisés Ackerman
e5c00c4dea
Replace quickstart scenarios with daml script (#12827)
* Replace references to scenarios with script in quickstart guide

* ensure initial part of trade_test matches initialize script

* update transaction view result

changelog_begin
changelog_end
2022-02-09 18:48:09 +01:00
Moritz Kiefer
eb19df6cd8
Setup infrastructure to cross-link to Canton docs (#12824)
* Setup infrastructure to cross-link to Canton docs

fixes #12811

changelog_begin
changelog_end

* .

changelog_begin
changelog_end
2022-02-09 16:21:56 +01:00
Moritz Kiefer
54e5e66e0b
Update Sandbox docs for Canton sandbox (#12796)
I tried finding some sensible balance between inlining things to make
them easily accessible for common stuff and referencing the upstream
docs but open to suggestions to shift that in either direction.

changelog_begin
changelog_end
2022-02-08 17:10:38 +01:00
Robert Autenrieth
f964c5d3c5
Use correct auth word (#12810)
changelog_begin
changelog_end
2022-02-08 13:42:01 +01:00
Moisés Ackerman
f0dd2de506
Remove scenarios from daml-studio docs (#12750)
* remove scenario from daml-studio Abort example

* remove scenario from daml-studio CreateAuthFailure example

* remove scenario from daml-studio ExerciseAuthFailure example

* remove scenario from daml-studio NotVisibleFailure example

* replace references to 'scenario' with 'script'

* update Iou copyright notice

* update daml-studio docs pictures

changelog_begin
changelog_end
2022-02-07 11:53:37 +01:00
matevarga-da
83b9d5ab0b
Fixing repetition by mistake in the docs of JSON API > Production Setup > Data Continuity (#12780)
CHANGELOG_BEGIN
CHANGELOG_END
2022-02-07 08:36:55 +01:00
Sergey Kisel
ce5030fc9a
Align Daml Script intro section of the docs with picture (#12742)
CHANGELOG_BEGIN
CHANGELOG_END
2022-02-04 12:36:52 +01:00
pbatko-da
6926e9adb4
Deprecate user identity service [DPP-862] (#12694)
changelog_begin
Ledger API Specification: Ledger Identity service is now deprecated.
changelog_end
2022-02-04 10:32:09 +01:00
Moritz Kiefer
486c869986
Replace most scenario references in the docs by Daml script (#12741)
* Replace most scenario references in the docs by Daml script

There are still some left in the Daml studio docs (should be updated)
and in quickstart-java (should be updated but probably not by us
🤷) but I’ll leave those for separate PRs.

changelog_begin
changelog_end

* delete unused code

changelog_begin
changelog_end
2022-02-03 15:55:55 +00:00
Moritz Kiefer
609537bd0d
Make gsg-trigger docs work with Canton (#12709)
Sadly most of these changes are not actually related to Canton but the
previous docs were already broken primarily because of the patch file
not making all the required changes.

I got the patch file as close as possible to the `messaging.patch` to
make it easier to keep them in sync. The fact that we have two patch
files that duplicate most of the code is something that we really need
to fix but not in this PR.

changelog_begin
changelog_end
2022-02-03 15:22:45 +01:00
Sergey Kisel
de444b29d7
Fix broken link in First Feature (#12735)
* Fix broken link in First Feature 

changelog_begin
changelog_end
2022-02-03 14:23:45 +01:00
Moritz Kiefer
7a5172c025
Make daml-script docs work with a Canton sandbox (#12695)
* Make daml-script docs work with a Canton sandbox

This addresses a few issues:

1. The `--wallclock-time` option does not work.
2. Display names are garbage so dropped the "solution" for
`listKnownParties`.
3. We cannot allocate fixed parties even with
`allocatePartyWithHint`. Switched to `--output-file` and user mgmt.

changelog_begin
changelog_end

* .

changelog_begin
changelog_end

* .

changelog_begin
changelog_end

* debug windows

changelog_begin
changelog_end

* .

changelog_begin
changelog_end

* .

changelog_begin
changelog_end

* debug scriptexample

changelog_begin
changelog_end

* .

changelog_begin
changelog_end

* .

changelog_begin
changelog_end

* .

changelog_begin
changelog_end

* .

changelog_begin
changelog_end

* .

changelog_begin
changelog_end

* .

changelog_begin
changelog_end

* Update docs/source/daml-script/index.rst
2022-02-02 21:01:44 +00:00
davidrichards-da
b4ed15bab7
Changed product names in the documentation (#12668)
* Changes to product names

CHANGELOG_BEGIN
CHANGELOG_END

Terminology changes made:
- Removing reference to 'Connect'
- Changing the product names

* Update docs/source/support/overview.rst

Co-authored-by: Moritz Kiefer <moritz.kiefer@purelyfunctional.org>

* Update docs/source/getting-started/installation.rst

Co-authored-by: Stefano Baghino <43749967+stefanobaghino-da@users.noreply.github.com>

* Update docs/source/ops/connect/auth0.rst

Co-authored-by: Stefano Baghino <43749967+stefanobaghino-da@users.noreply.github.com>

* Update docs/source/ops/connect/auth0.rst

Co-authored-by: Stefano Baghino <43749967+stefanobaghino-da@users.noreply.github.com>

* Update docs/source/ops/connect/helm.rst

Co-authored-by: Stefano Baghino <43749967+stefanobaghino-da@users.noreply.github.com>

* Update docs/source/ops/connect/helm.rst

Co-authored-by: Stefano Baghino <43749967+stefanobaghino-da@users.noreply.github.com>

* Update docs/source/ops/connect/index.rst

Co-authored-by: Stefano Baghino <43749967+stefanobaghino-da@users.noreply.github.com>

* Update docs/source/support/compatibility.rst

Co-authored-by: Stefano Baghino <43749967+stefanobaghino-da@users.noreply.github.com>

* Update docs/source/support/compatibility.rst

Co-authored-by: Stefano Baghino <43749967+stefanobaghino-da@users.noreply.github.com>

* Update docs/source/tools/trigger-service/auth0_example.rst

Co-authored-by: Stefano Baghino <43749967+stefanobaghino-da@users.noreply.github.com>

Co-authored-by: Moritz Kiefer <moritz.kiefer@purelyfunctional.org>
Co-authored-by: Stefano Baghino <43749967+stefanobaghino-da@users.noreply.github.com>
2022-02-01 15:15:12 +01:00
Moisés Ackerman
e4764cc426
Upgrade to GHC 9.0.2 (#12300)
changelog_begin
changelog_end

Co-authored-by: Moritz Kiefer <moritz.kiefer@purelyfunctional.org>
2022-02-01 11:27:11 +01:00
Moritz Kiefer
1238e1b66b
Update profiling documentation to Canton sandbox (#12680)
changelog_begin
changelog_end
2022-02-01 10:00:53 +01:00
Victor Peter Rouven Müller
100c59fc24
[JSON-API] Docs for user management endpoints (#12432)
* Update user-endpoint docs to newest implementation changes

* Add the missing star!

Co-authored-by: Gary Verhaegen <gary.verhaegen@digitalasset.com>

* More stars!

Co-authored-by: Gary Verhaegen <gary.verhaegen@digitalasset.com>

* Remove reference and shorten endpoint descriptions

* Use the right rule for capitalizing in titles

* Update docs/source/json-api/index.rst

Co-authored-by: Stefano Baghino <43749967+stefanobaghino-da@users.noreply.github.com>

* Use user ID instead of user id

changelog_begin

- [HTTP-JSON] Added documentation for the new user management endpoints

changelog_end

* Apply suggestions from code review

Co-authored-by: Simon Meier <meiersi-da@users.noreply.github.com>

* Update docs for endpoint adjustments & address review comments

* Fix build error

Co-authored-by: Gary Verhaegen <gary.verhaegen@digitalasset.com>
Co-authored-by: Stefano Baghino <43749967+stefanobaghino-da@users.noreply.github.com>
Co-authored-by: Simon Meier <meiersi-da@users.noreply.github.com>
2022-01-31 18:05:21 +01:00
nicu-da
c1afabe653
[participant-state] Add earliest_offset metadata to pruned data error [kvl-1270] (#12546) 2022-01-31 16:54:24 +00:00
Jennifer Whyte
7305a8c297
Color and typography edits (#12609)
CHANGELOG_BEGIN
CHANGELOG_END
2022-01-26 17:35:01 -05:00
Moisés Ackerman
dcd721da99
Drop scenarios (#12484)
* Remove scenarios from user examples

* Remove scenarios from tests

* implicitly enable scenario service for doctests

changelog_begin
changelog_end
2022-01-24 18:42:42 +01:00
Simon Meier
01447fd489
docs: typos and minor clarification for authz docs (#12534)
CHANGELOG_BEGIN
CHANGELOG_END
2022-01-24 10:42:30 +01:00
Andreas Lochbihler
20cda0181a
specify that deduplication offsets are exclusive (#12488)
CHANGELOG_BEGIN
CHANGELOG_END
2022-01-21 09:52:33 +01:00
mziolekda
c35d34db3d
Remove ResetService from the grpc documentation (#12512)
CHANGELOG_BEGIN
CHANGELOG_END
2022-01-20 16:19:04 +01:00
Simon Meier
0f8e40c92d
user management: add reference docs (#12398)
CHANGELOG_BEGIN
CHANGELOG_END
2022-01-20 10:32:28 +00:00
mziolekda
82534f9155
Remove the reset service from the ledger api and the documentation [DPP-804] (#12472)
* Remove reset service from grpc and documentation [DPP-804]

CHANGELOG_BEGIN
Remove reset service from the ledger api protocol and the documentation
CHANGELOG_END

* remove reset service from two left-over places

* remove reset service from the protobuf structure test
2022-01-19 14:46:50 +01:00
Moritz Kiefer
eb2281dd73
Move more docs post processing to non-sphinx docs (#12463)
This moves the redirects, the error page and the dummy versions file
to the non-sphinx html tarball which is handled in the split release
process.

This leaves only copying the pdf docs and the site map as a post
processing step which I cannot easily do here (since they should both
refer to the final artifact) so I’ll add that
directly in the assembly repo.

changelog_begin
changelog_end
2022-01-18 17:09:59 +00:00
Sofia Faro
b2a7f9e640
Change default sandbox to canton (#12438)
* Change default sandbox to canton.

Some progress on #11831

* made `daml start` use canton sandbox by default
  * changed the non-ledger api ports to use free ports by default
    (still haven't tried using port 0 instead of `getFreePort`).
* renamed `daml sandbox-canton` to `daml sandbox`
* implement a `--static-time` option for `daml sandbox` that sets the
  canton clock type parameter to `sim-clock`
* moved the quickstart-java integration test to use the new sandbox
  * the test uses `--static-time`, but doesn't really depend on it

changelog_begin
changelog_end

* fix parens

* fix hot reload test

* reinstant --sandbox-kv in create-daml-app test for now

* fix damlStart test
2022-01-18 09:10:58 +00:00
Moritz Kiefer
2005068e3e
Drop platform-version support from daml.yaml (#12397)
* Drop `platform-version` support from `daml.yaml`

Doesn’t work properly with Canton sandbox, nobody uses it and product
agreed to deleting it.

changelog_begin
changelog_end

* drop run-platform-jar

changelog_begin
changelog_end

* fix run-jar commands

changelog_begin
changelog_end
2022-01-13 16:32:24 +00:00
Moritz Kiefer
da55bd48d8
Simplify sphinx -Werror (#12372)
Grepping for warnings seems unnecessarily complex given that sphinx
has `-W` for that. I did verify that this indeed fails the builds on
warnings (tried out with a missing include).

changelog_begin
changelog_end
2022-01-12 11:33:39 +00:00
akshayshirahatti-da
50de6e3639
[JSON-API] HOCON config json api (#12236)
* Change heartBeatPer to more intuitive naming of heartbeatPeriod

CHANGELOG_BEGIN
CHANGELOG_END

* Initial changes to add HOCON config for json_api

CHANGELOG_BEGIN
CHANGELOG_END

* avoid IllegalArgumentException noise

* use named arguments in big config conversion

* Changes include
 - tests for a full http-json-api config file
 - logging config and non-repudiation config is still specified via cli args.
 - config readers for MetricsReporter

* Add defaults to WebsocketConfig case class to allow partially specifying fields on typeconf file

* changes to the JwtVerifierBase config reader and equivalent test

* message already describes the value

* replace manual succeed/fails with scalatest combinators

* use qualified imports for WebsocketConfig defaults

* add back autodeleted empty lines

* collapse two lists of token verifiers into one

* add new line to config files

* rename dbStartupMode to startMode to keep consistent with cli option and for easy documentation

* Changes to daml docs to specify ways to run JSON-API by supplying a HOCON config file.

CHANGELOG_BEGIN
JSON-API can now be started supplying a HOCON application config file using the `--config` option.
All CLI flags except `logging` and `non-repudiation` one's are now deprecated and will be cleaned up in some future releases.
CHANGELOG_END

Co-authored-by: Stephen Compall <stephen.compall@daml.com>
2022-01-10 23:07:07 +00:00
akshayshirahatti-da
4f4d18829b
[Trigger-Service] Changes to use a typeconfig conf for trigger-service when provided. (#12217)
* Changes to add the option of starting trigger service with typeconf/HOCON config

CHANGELOG_BEGIN
CHANGELOG_END

* add tests for authorization config and fail on both config file and cli args

* refactor and cleanup config loading and tests

* Changes based on code review comments

* Daml doc changes and making sure that we have defaults for most fields to mirror cli args

CHANGELOG_BEGIN
Trigger Service can now be configured with HOCON config file.
 - If a config file is provided we will choose to start the service using that, else we will fallback to cli arguments.
 - If both config file and cli args are provided we will error out.
CHANGELOG_END

* addressing some more code review comments

* use scalatest inside properly
2022-01-06 00:12:47 +00:00
Gary Verhaegen
ea55ea2d14
Further copyright updates (#12249)
Somewhat error-prone, so please review carefully.

Reasons we need this:

- Some file types are not properly handled by the script.
- The only exclusion mechanism we currently have (`NO_AUTO_COPYRIGHT`)
  is overly coarse.

CHANGELOG_BEGIN
CHANGELOG_END
2022-01-04 16:32:17 +01:00
Gary Verhaegen
d2e2c21684
update copyright headers (#12240)
New year, new copyright, new expected unknown issues with various files
that won't be covered by the script and/or will be but shouldn't change.

I'll do the details on Jan 1, but would appreciate this being
preapproved so I can actually get it merged by then.

CHANGELOG_BEGIN
CHANGELOG_END
2022-01-03 16:36:51 +00:00
Moisés Ackerman
ba0c6c9841
Set --enable-scenarios to False by default (#12156)
* Set --enable-scenarios to False by default

changelog_begin
changelog_end

* Enable scenarios for shake test

* Add --enable-scenarios=yes for //compiler/lsp-tests

* Add enable_scenarios arg to rules_daml/daml.bzl helpers

* daml_compile
* daml_build_test
* daml_test

* Add enable_scenarios to ledger/test-common helper da_scala_dar_resources_library

* Add --enable-scenarios=yes for //ledger/test-common

* Remove unused scenario in //ledger/test-common PingPong test

* Add --enable-scenarios=yes for //daml-lf/tests

* Add --enable-scenarios=yes for //language-support/java tests

* Add --enable-scenarios=yes for group-chat example

* Add --enable-scenarios for //ledger/sandbox-perf LargeTransaction test

* Add --enable-scenarios=yes for //docs tests

* Add --enable-scenarios=yes for //daml-lf/scenario-interpreter tests

* format bazel

* Add --enable-scenario=yes for 'daml_doc_test's

* Add --enable-scenarios=yes for DamlDocTestIntegration

* Add --enable-scenarios=yes for DamlcTest

* Add --enable-scenarios=yes for Test/DataDependencies

* Add --enable-scenarios=yes for daml-ghc-deterministic.sh

* Add --enable-scenarios=yes for Test.IncrementalBuilds

* Add --enable-scenarios=yes for tests:memory-bond-trading and tests:memory-examples

* Add --enable-scenarios=yes for daml-assistant/integratio-tests
2021-12-20 19:31:06 +01:00