docs: fix tsdoc syntax and recover dropped @PARAM field docs (#1650)

* docs: fix tsdoc syntax and recover dropped @PARAM field docs

* fix: clean up tsdoc syntax, restore broken reference cross-links

Author: quietbits

docs/reference/contracts-client.md

@@ -54,7 +54,7 @@ constructor(code: string, issuer?: string);
 
 Compares two assets according to the criteria:
 
- 1. First compare the type (native < alphanum4 < alphanum12).
+ 1. First compare the type (`native < alphanum4 < alphanum12`).
  2. If the types are equal, compare the assets codes.
  3. If the asset codes are equal, compare the issuers.
 
@@ -126,7 +126,7 @@ contractId(networkPassphrase: string): string;
 
 - **`networkPassphrase`** — `string` (required) — indicates which network the contract
      ID should refer to, since every network will have a unique ID for the
-     same contract (see `Networks` for options)
+     same contract (see [`Networks`](/reference/core-transactions/#networks) for options)
 
 **Source:** [src/base/asset.ts:172](https://github.com/stellar/js-stellar-sdk/blob/main/src/base/asset.ts#L172)
 
@@ -152,7 +152,7 @@ getAssetType(): AssetType;
 
 **Throws**
 
-- Throws `Error` if asset type is unsupported.
+- if asset type is unsupported.
 
 **See also**
 
@@ -455,8 +455,8 @@ constructor(assetA: Asset, assetB: Asset, fee: number);
 
 **Parameters**
 
-- **`assetA`** — `Asset` (required) — The first asset in the Pool, it must respect the rule assetA < assetB. See `Asset.compare` for more details on how assets are sorted.
-- **`assetB`** — `Asset` (required) — The second asset in the Pool, it must respect the rule assetA < assetB. See `Asset.compare` for more details on how assets are sorted.
+- **`assetA`** — `Asset` (required) — The first asset in the Pool, it must respect the rule `assetA < assetB`. See [`Asset.compare`](#assetcompareasseta-assetb) for more details on how assets are sorted.
+- **`assetB`** — `Asset` (required) — The second asset in the Pool, it must respect the rule `assetA < assetB`. See [`Asset.compare`](#assetcompareasseta-assetb) for more details on how assets are sorted.
 - **`fee`** — `number` (required) — The liquidity pool fee. For now the only fee supported is `30`.
 
 **Source:** [src/base/liquidity_pool_asset.ts:27](https://github.com/stellar/js-stellar-sdk/blob/main/src/base/liquidity_pool_asset.ts#L27)
@@ -552,9 +552,9 @@ toString(): string;
 
 Returns the `xdr.ChangeTrustAsset` object for this liquidity pool asset.
 
-Note: To convert from an ``Asset`` to `xdr.ChangeTrustAsset`
+Note: To convert from an [``Asset``](#asset) to `xdr.ChangeTrustAsset`
 please refer to the
-``Asset.toChangeTrustXdrObject`` method.
+[``Asset.toChangeTrustXdrObject``](#assettochangetrustxdrobject) method.
 
 ```ts
 toXdrObject(): ChangeTrustAsset;
@@ -676,9 +676,9 @@ toString(): string;
 
 Returns the `xdr.TrustLineAsset` object for this liquidity pool ID.
 
-Note: To convert from ``Asset`` to `xdr.TrustLineAsset` please
+Note: To convert from [``Asset``](#asset) to `xdr.TrustLineAsset` please
 refer to the
-``Asset.toTrustLineXdrObject`` method.
+[``Asset.toTrustLineXdrObject``](#assettotrustlinexdrobject) method.
 
 ```ts
 toXdrObject(): TrustLineAsset;
@@ -701,6 +701,9 @@ getLiquidityPoolId(liquidityPoolType: "constant_product", liquidityPoolParameter
 
 - **`liquidityPoolType`** — `"constant_product"` (required) — A string representing the liquidity pool type.
 - **`liquidityPoolParameters`** — `ConstantProduct` (required) — The liquidity pool parameters.
+    - `assetA`: The first asset in the Pool, it must respect the rule `assetA < assetB`.
+    - `assetB`: The second asset in the Pool, it must respect the rule `assetA < assetB`.
+    - `fee`: The liquidity pool fee. For now the only fee supported is `30`.
 
 **See also**
 

docs/reference/core-assets.md

@@ -55,6 +55,9 @@ constructor(keys: { publicKey?: string | Uint8Array<ArrayBufferLike>; secretKey:
 **Parameters**
 
 - **`keys`** — `{ publicKey?: string | Uint8Array<ArrayBufferLike>; secretKey: string | Uint8Array<ArrayBufferLike>; type: "ed25519" } | { publicKey: string | Uint8Array<ArrayBufferLike>; type: "ed25519" }` (required) — at least one of keys must be provided.
+    - `type`: public-key signature system name (currently only `ed25519` keys are supported)
+    - `publicKey`: raw public key
+    - `secretKey`: raw secret key (32-byte secret seed in ed25519)
 
 **Source:** [src/base/keypair.ts:80](https://github.com/stellar/js-stellar-sdk/blob/main/src/base/keypair.ts#L80)
 
@@ -395,10 +398,10 @@ xdrPublicKey(): PublicKeyEd25519;
 ## SignerKey
 
 A container class with helpers to convert between signer keys
-(`xdr.SignerKey`) and `StrKey`s.
+(`xdr.SignerKey`) and [`StrKey`](#strkey)s.
 
 It's primarily used for manipulating the `extraSigners` precondition on a
-`Transaction`.
+[`Transaction`](/reference/core-transactions/#transaction).
 
 ```ts
 class SignerKey {
@@ -410,7 +413,7 @@ class SignerKey {
 
 **See also**
 
-- `TransactionBuilder.setExtraSigners`
+- [`TransactionBuilder.setExtraSigners`](/reference/core-transactions/#transactionbuildersetextrasignersextrasigners)
 
 **Source:** [src/base/signerkey.ts:22](https://github.com/stellar/js-stellar-sdk/blob/main/src/base/signerkey.ts#L22)