Commit Graph

1222 Commits

Author SHA1 Message Date
Wallace Kelly
52445ad48f
Clarify the ledger time docs (#16236)
* Move the Redeem related paragraphs up

* Reduce use of "ledger" when discussing RT

* Rewrite the explanation of LT and RT

* Clarify the "moving the clock back" example

* Carrie: remove "a bit" from "challenging"

Co-authored-by: carrielaben-da <91496516+carrielaben-da@users.noreply.github.com>

* Carrie: exactly how to assign the record time

Co-authored-by: carrielaben-da <91496516+carrielaben-da@users.noreply.github.com>

* Carrie: the choice doesn't do anything

Co-authored-by: carrielaben-da <91496516+carrielaben-da@users.noreply.github.com>

* Carrie: has two timestamps:

Co-authored-by: carrielaben-da <91496516+carrielaben-da@users.noreply.github.com>

* Carrie: as determined by the participant

Co-authored-by: carrielaben-da <91496516+carrielaben-da@users.noreply.github.com>

* Carrie: The only purpose of the RT

Co-authored-by: carrielaben-da <91496516+carrielaben-da@users.noreply.github.com>

* Carrie: This is the requirement known as

Co-authored-by: carrielaben-da <91496516+carrielaben-da@users.noreply.github.com>

* Carrie: LT or RT are strictly increasing

Co-authored-by: carrielaben-da <91496516+carrielaben-da@users.noreply.github.com>

* Andrae: concept of a current time

* andrae: Non-fp friendly Redeem example

* andrae: better text around the Redeem example

* andrae: Remove details about skew alg

* andrae: remove misleading use of "commit"

* wallace: fix work hours boolean

* andrae: restore the case statement

Co-authored-by: Andrae Muys <andrae.muys@digitalasset.com>

* wallace: fix GitHub merge suggestion issue

* Lois: Correct "It is timestamp..."

Co-authored-by: Lois Kilberg <116729229+loiskilberg-da@users.noreply.github.com>

* Lois: Correct "and is assigned..."

Co-authored-by: Lois Kilberg <116729229+loiskilberg-da@users.noreply.github.com>

* Lois: Replace contraction doesn't

Co-authored-by: Lois Kilberg <116729229+loiskilberg-da@users.noreply.github.com>

* Lois: Remove "Notice..."

Co-authored-by: Lois Kilberg <116729229+loiskilberg-da@users.noreply.github.com>

* Lois: Replace "Now let's look at..."

Co-authored-by: Lois Kilberg <116729229+loiskilberg-da@users.noreply.github.com>

* Lois: Replace "given" and "it's"

Co-authored-by: Lois Kilberg <116729229+loiskilberg-da@users.noreply.github.com>

* Lois: Replace contraction "won't"

Co-authored-by: Lois Kilberg <116729229+loiskilberg-da@users.noreply.github.com>

---------

Co-authored-by: carrielaben-da <91496516+carrielaben-da@users.noreply.github.com>
Co-authored-by: Andrae Muys <andrae.muys@digitalasset.com>
Co-authored-by: Lois Kilberg <116729229+loiskilberg-da@users.noreply.github.com>
Co-authored-by: Gary Verhaegen <gary.verhaegen@digitalasset.com>
2023-02-27 17:58:17 +00:00
Gary Verhaegen
7f36d5e4b1
[docs] remove manually-edited rst files (#16376)
They are moving to the docs repo. I'm removing them here first and will
add to the docs repo afterwards, to avoid losing edits in the meantime.
2023-02-23 15:55:04 +01:00
Nicu Reut
cc0db80b3a
Remove duplicate HTTP metrics replaced by the golden signal metrics [PLEN-117] (#16341) 2023-02-22 13:42:24 +01:00
mziolekda
4c187673b8
bump ledger-api version to 2.3 (#16338)
* bump ledger-api version

* typos

* missing the
2023-02-17 18:18:49 +01:00
Samuel Williams
fb55f4c1bb
Add signatory labels to create and fetch in tree view (#16291)
* Add signatory labels to create and fetch in tree view

* Switch node printing in scala and expected ledger files

* Update docs/images

* Update party formatting to use `x, y and z` and correct verb tense

* Update scala to match haskell, update tests and docs (except images)

* Cleanup code from suggestions

* Fix misformatting, refactor
2023-02-16 15:57:01 +00:00
Wallace Kelly
9ccf6b8df2
Simplify the Keys.daml example (#15591)
* Simplify the Keys.daml example

* Lois: Remove "we" and "Now even after"

Co-authored-by: Lois Kilberg <116729229+loiskilberg-da@users.noreply.github.com>

* Lois: Remove "Notice that..."

Co-authored-by: Lois Kilberg <116729229+loiskilberg-da@users.noreply.github.com>

---------

Co-authored-by: Lois Kilberg <116729229+loiskilberg-da@users.noreply.github.com>
2023-02-16 14:08:31 +01:00
Gary Verhaegen
e113aa9118
delete page moved to docs repo (#16322)
See https://github.com/digital-asset/docs.daml.com/pull/166.
2023-02-15 19:32:07 +00:00
Simon Maxen
6f96aa5e0b
Event query service [DPP-1366] (#16273)
* Add EventQueryService (conformance disabled)

* Update with review comments

* Limit by ledger end

* Limit iterations searching for visible contract key

* Test with choice that recreates key

* Update proto comments

* Add to event query service to services document

* Inject message into token validator

* Fix docs typo

* Improve docs
2023-02-15 17:01:14 +01:00
Wallace Kelly
e103898dd9
Replace Party with allocateParty as Action example (#15583) 2023-02-15 08:50:55 +00:00
Wallace Kelly
6ab9159f39
Simplify daml test CLI example (#15411)
I don't see any reason to use `daml damlc -- test --files Token_Test.daml`, when `daml test --files Token_Test.daml` appears to have identical output:

```
➜  intro2 git:(main) ✗ daml damlc -- test --files daml/Token_Test.daml

Test Summary
daml/Token_Test.daml:token_test: ok, 1 active contracts, 6 transactions.
daml/Token_Test.daml:token_test_1: ok, 1 active contracts, 1 transactions.
daml/Token_Test.daml:token_test_2: ok, 2 active contracts, 4 transactions.
daml/Token_Test.daml:token_test_3: ok, 0 active contracts, 3 transactions.
test coverage: templates 100%, choices 100%

➜  intro2 git:(main) ✗ daml test --files daml/Token_Test.daml

Test Summary
daml/Token_Test.daml:token_test: ok, 1 active contracts, 6 transactions.
daml/Token_Test.daml:token_test_1: ok, 1 active contracts, 1 transactions.
daml/Token_Test.daml:token_test_2: ok, 2 active contracts, 4 transactions.
daml/Token_Test.daml:token_test_3: ok, 0 active contracts, 3 transactions.
test coverage: templates 100%, choices 100%
➜  intro2 git:(main) ✗
```

CHANGELOG_BEGIN
CHANGELOG_END
2023-02-15 09:05:13 +01:00
Gary Verhaegen
d83068e7f3
[docs] fix link in bindings-ts (#16315) 2023-02-14 16:32:14 +01:00
Moisés Ackerman
423891b88a
intro to exceptions: test IOUs are created and exception is thrown (#16305)
* intro to exceptions: test IOUs are created and exception is thrown

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

* snake_case => camelCase

---------

Co-authored-by: Gary Verhaegen <gary.verhaegen@digitalasset.com>
2023-02-13 15:18:17 +00:00
Gary Verhaegen
aa946a26b4
fix Exception intro template (#16303) 2023-02-13 10:08:41 +00:00
carrielaben-da
8d94bdd6e4
Typo fix in 11_StdLib.rst (#16264)
Corrected an instance of the wrong "its" and adjusted some grammar.

[CHANGELOG_BEGIN]
[CHANGELOG_END]

Co-authored-by: carrie-laben <91496516+carrie-laben@users.noreply.github.com>
2023-02-08 09:07:35 -05:00
pbatko-da
eb0c90a173
[DPP-954][Docs] Improve pruning offsets docs (#16254) 2023-02-08 11:09:34 +00:00
Nicu Reut
9642859062
Add OpenTelemetry JVM metrics documentation [PLEN-67] (#16202) 2023-02-03 16:20:01 +00:00
da-katmurp
0392e439b8
Adding missing content about Archiving in docs (#16150)
* adding info to write daml section

* adding archive to reference docs

* add note about consuming choice

* Update docs/source/daml/intro/2_DamlScript.rst

Co-authored-by: Leonid Rozenberg <leonid.rozenberg@digitalasset.com>

* Update docs/source/daml/reference/updates.rst

Co-authored-by: Leonid Rozenberg <leonid.rozenberg@digitalasset.com>

* Update docs/source/daml/reference/updates.rst

Co-authored-by: Leonid Rozenberg <leonid.rozenberg@digitalasset.com>

* Update docs/source/daml/reference/updates.rst

Co-authored-by: Leonid Rozenberg <leonid.rozenberg@digitalasset.com>

* Update docs/source/daml/reference/updates.rst

Co-authored-by: Leonid Rozenberg <leonid.rozenberg@digitalasset.com>

* including extra statement about implicit Archive choice

* fix the build

---------

Co-authored-by: Leonid Rozenberg <leonid.rozenberg@digitalasset.com>
2023-02-01 17:30:05 +01:00
Luc Bourlier
e809344c00
Metrics for node status [PLEN-63] (#16052)
* Metrics for node status [PLEN-63]

CHANGELOG_BEGIN

* Node status metric: daml_health_status

CHANGELOG_END
2023-01-26 12:01:14 +01:00
Luc Bourlier
dec4738f53
Adds documentation for pruning metrics (#16099)
* Adds documentation for pruning metrics

CHANGELOG_BEGIN

CHANGELOG_END

* Apply suggestions from code review

Co-authored-by: da-katmurp <117752519+da-katmurp@users.noreply.github.com>

Co-authored-by: Luc Bourlier <lb@skyluc.org>
Co-authored-by: da-katmurp <117752519+da-katmurp@users.noreply.github.com>
2023-01-25 18:10:48 +01:00
shimonzerbib-da
0ca0738740
Update glossary.rst (#16144)
Fixed some tenses and addressed some spelling errors.
2023-01-24 13:11:47 -05:00
dylant-da
d79a6f406c
Write documentation for daml test coverage report (#16024)
Co-authored-by: katmurp <117752519+katmurp@users.noreply.github.com>
2023-01-16 12:56:48 +00:00
Moisés Ackerman
d8041563d7
Motivate viewtype in intro to interfaces (#16057)
Co-authored-by: Bernhard Elsner <40762178+bame-da@users.noreply.github.com>
Co-authored-by: Stefano Baghino <43749967+stefanobaghino-da@users.noreply.github.com>
2023-01-13 14:39:31 +00:00
da-katmurp
9bfdeab3dd
splitting acs doc into two pages (#16036) 2023-01-13 15:13:48 +01:00
Moisés Ackerman
48a19cbbb6
Add missing 'HasAgreement t' constraints in daml-intro-13 (#16051) 2023-01-12 16:27:54 +00:00
Moisés Ackerman
3633d3bb52
Require HasAgreement t in template-only daml-script/daml-trigger functions (#16039) 2023-01-12 13:55:30 +01:00
Moisés Ackerman
bc79f15ae0
[Docs] Introduction to interfaces (#15837)
* Add Cash template

* Add NFT template

* Add Asset interface

* Add interface instance Asset for Cash

* Add interface instance Asset for NFT

* Add tests for Asset interface instances

* add comment for RejectTransfer/WithdrawProposal

* Use unqualified 'view' function in 'view' definition

* Prefix interface types with I and view types with V

* Use verbose names for templates and choices

* Add example for queryInterface

* Add example for queryInterfaceContractId

* Define tests as functions taking 'Parties'

* Define cashAndNftTest reusing mkAssetTest

* cashAndNftTest checks the return value of queryInterface directly

* Use 'debug' on the result of 'queryInterface{,ContractId}'

* Interface instances

* capitalize names

* Polymorphic Daml Script

* Add hint about serializable types under viewtype

Co-authored-by: Remy <remy.haemmerle@daml.com>
Co-authored-by: carrielaben-da <91496516+carrielaben-da@users.noreply.github.com>
Co-authored-by: Stefano Baghino <43749967+stefanobaghino-da@users.noreply.github.com>
2023-01-12 12:11:53 +01:00
Gary Verhaegen
fbba580410
docs/gpg: additional update (#16043) 2023-01-11 22:19:13 +00:00
Gary Verhaegen
1fd0c5bf2d
update docs to mention the new key (#16042)
Note: this is only going to affect 2.6.0 docs and later; the existing,
published documentation will be updated manually to match.
2023-01-11 21:13:16 +00:00
carrielaben-da
b485a01ca8
Language Review of acs.rst (#16026)
* Update acs.rst

Language review

[CHANGELOG_BEGIN]
[CHANGELOG_END]

* Update docs/source/daml/resource-management/acs.rst

[CHANGELOG_BEGIN]
[CHANGELOG_END}

Co-authored-by: katmurp <117752519+katmurp@users.noreply.github.com>

* Update docs/source/daml/resource-management/acs.rst

[CHANGELOG_BEGIN]
[CHANGELOG_END]

Co-authored-by: katmurp <117752519+katmurp@users.noreply.github.com>

Co-authored-by: carrie-laben <91496516+carrie-laben@users.noreply.github.com>
Co-authored-by: katmurp <117752519+katmurp@users.noreply.github.com>
2023-01-11 08:33:18 +01:00
Lois Kilberg
3e202617ee
update Authentication.svg image and fix bulleted list (#16031)
- Update the image to change "DAML" to "Daml"
- Add blank line before bulleted list to be recognized as a list

[CHANGELOG_BEGIN]
[CHANGELOG_END]
2023-01-10 10:36:13 -04:00
mjuchli-da
12b03094e1
[Docs] Swap sentences to comply with evaluation logic (#15962)
Statements generally are evaluated by preorder traversal. Thus the second and third (last) consequences need to be swapped (as they otherwise would follow level-order traversal).
2023-01-06 10:01:40 +01:00
Gary Verhaegen
151e12b81a
bump copyright (#16002)
This is the result of:

- Updating `./COPY` to say `2023`.
- Running `./dev-env/bin/dade-copyright-headers update .`
2023-01-04 18:21:15 +01:00
yves-da
440b582ebe
Improve Daml introduction text (#15943)
Removes superfluous second sentence which also assumes the reader to be familiar with object-oriented programming.

CHANGELOG_BEGIN
CHANGELOG_END
2022-12-20 14:20:15 +01:00
Raymond Roestenburg (Actually RayRoestenburg)
3af878c4ad
Docs: custom views code example fix. (#15928) 2022-12-19 14:31:45 +00:00
Nicu Reut
c8c5eaa11f
Add metrics to execution services [PLEN-64] (#15861) 2022-12-15 15:34:25 +00:00
katmurp
e47bca3569
Docs: Resource management - Latency/throughput, ACS size (#15854)
* resource management - ACS size

* adding throughput and latency section
2022-12-15 12:00:28 +01:00
katmurp
b3efb02f32
removing no-context content (#15873) 2022-12-12 19:16:16 +01:00
Miklos
393dda5578
Documented metrics for oauth2-middleware [PLEN-57] (#15838) 2022-12-09 14:31:19 +01:00
Raymond Roestenburg (Actually RayRoestenburg)
4db604cc6f
custom views inline examples update. (#15847) 2022-12-09 14:17:28 +01:00
carrielaben-da
c16ab91a17
Adding H2 to high-level-intro.rst (#15842)
Adds an H2 immediately following the H1, which should hopefully correct the formatting issue with this page in the TOC

[CHANGELOG_BEGIN]
[CHANGELOG_END]

Co-authored-by: carrie-laben <91496516+carrie-laben@users.noreply.github.com>
2022-12-08 15:24:38 -05:00
Stefano Baghino
18ed316827
Accept uppercase English alphabet letters in user IDs (#15832)
* Accept uppercase English alphabet letters in user IDs

changelog_begin
Accept uppercase English alphabet letters in user IDs
changelog_end

* Fix title case in docs change

Co-authored-by: Sergey Kisel <98825453+skisel-da@users.noreply.github.com>

Co-authored-by: Sergey Kisel <98825453+skisel-da@users.noreply.github.com>
2022-12-08 16:44:54 +00:00
Raymond Roestenburg (Actually RayRoestenburg)
0f262b16e2
db migration doc for custom views. (#15821) 2022-12-07 15:59:21 +01:00
Lois Kilberg
610b06859e
update two images with higher resolution (#15810)
Replace the two diagram images with files that have a higher resolution.

[CHANGELOG_BEGIN]
[CHANGELOG_END]
2022-12-07 08:19:44 -05:00
Raymond Roestenburg (Actually RayRoestenburg)
83497222a0
Changed custom views doc, using a DataSource. (#15808)
* Changed custom views doc, using a DataSource.

* Fix code block.
2022-12-07 13:52:52 +01:00
Gary Verhaegen
ba4841d768
docs: remove unwanted files (#15816) 2022-12-07 12:41:31 +00:00
Chun Lok Ling
3a17c9413a
Added documentation on how to provide access token (#15783)
* add authorization doc for custom views

* fix link

* Update docs/source/app-dev/custom-views/index.rst

Co-authored-by: Raymond Roestenburg (Actually RayRoestenburg) <98821776+ray-roestenburg-da@users.noreply.github.com>

* Update docs/source/app-dev/custom-views/index.rst

Co-authored-by: Raymond Roestenburg (Actually RayRoestenburg) <98821776+ray-roestenburg-da@users.noreply.github.com>

* addressed comments

* remove

Co-authored-by: Raymond Roestenburg (Actually RayRoestenburg) <98821776+ray-roestenburg-da@users.noreply.github.com>
2022-12-06 18:24:49 +00:00
Moisés Ackerman
f35ebb8dcd
Move stdlib datatypes into stable packages (#15795)
* Move datatype DA.Action.State.State into a stable package

* Move datatype DA.Stack.SrcLoc into a stable package

* Move datatype DA.Random.Minstd into a stable package

* Skip doctest for DA.Action.State.Type

* Don't use magic numbers in CodeGenRunnerTests.scala

* Update comment in StablePackageTest.scala
2022-12-06 15:48:35 +01:00
Gary Verhaegen
8782207d1a
docs: improve wording of Numeric n description (#15805) 2022-12-06 13:14:16 +00:00
carrielaben-da
0c80d346df
Delete tools.rst (#15752)
Removing the "Developer Tools" TOC, which is not used in the new 2.5 TOC
2022-12-01 10:41:23 +01:00
Lois Kilberg
989142a0db
fix numbered lists (#15730)
Added blank lines in two places before numbered lists so that they will be recognized as lists.

[CHANGELOG_BEGIN]
[CHANGELOG_END]
2022-11-30 14:21:13 -05:00