@wtf/release-docs 8.1.0 → 8.2.1

package/api/@wtf/release-maven/pom/interfaces/PomDependency.md

@@ -0,0 +1,51 @@
+[**Release trains**](../../../../README.md)
+
+***
+
+[Release trains](../../../../README.md) / [@wtf/release-maven/pom](../README.md) / PomDependency
+
+# Interface: PomDependency
+
+Defined in: [packages/release-maven/src/pom.ts:227](https://gitlab.com/wetryfun/release/release/-/blob/be2016d6f7c6f29592926b2f125da705da6376eb/packages/release-maven/src/pom.ts#L227)
+
+A dependency of a pom, as it writes it: each value its text, `undefined` where it has none.
+
+## Properties
+
+### artifactId
+
+> `readonly` **artifactId**: `string` \| `undefined`
+
+Defined in: [packages/release-maven/src/pom.ts:231](https://gitlab.com/wetryfun/release/release/-/blob/be2016d6f7c6f29592926b2f125da705da6376eb/packages/release-maven/src/pom.ts#L231)
+
+Its `artifactId`.
+
+***
+
+### groupId
+
+> `readonly` **groupId**: `string` \| `undefined`
+
+Defined in: [packages/release-maven/src/pom.ts:229](https://gitlab.com/wetryfun/release/release/-/blob/be2016d6f7c6f29592926b2f125da705da6376eb/packages/release-maven/src/pom.ts#L229)
+
+Its `groupId`, as written, as `${project.groupId}`.
+
+***
+
+### scope
+
+> `readonly` **scope**: `string` \| `undefined`
+
+Defined in: [packages/release-maven/src/pom.ts:235](https://gitlab.com/wetryfun/release/release/-/blob/be2016d6f7c6f29592926b2f125da705da6376eb/packages/release-maven/src/pom.ts#L235)
+
+Its `scope`, as `test`: none, Maven's `compile`.
+
+***
+
+### version
+
+> `readonly` **version**: `string` \| `undefined`
+
+Defined in: [packages/release-maven/src/pom.ts:233](https://gitlab.com/wetryfun/release/release/-/blob/be2016d6f7c6f29592926b2f125da705da6376eb/packages/release-maven/src/pom.ts#L233)
+
+Its `version`, as written, as `[1.0,2.0)` or `${project.version}`.

package/api/@wtf/release-maven/pom/interfaces/PomParent.md

@@ -0,0 +1,41 @@
+[**Release trains**](../../../../README.md)
+
+***
+
+[Release trains](../../../../README.md) / [@wtf/release-maven/pom](../README.md) / PomParent
+
+# Interface: PomParent
+
+Defined in: [packages/release-maven/src/pom.ts:251](https://gitlab.com/wetryfun/release/release/-/blob/be2016d6f7c6f29592926b2f125da705da6376eb/packages/release-maven/src/pom.ts#L251)
+
+The parent of a pom, of its `<parent>`.
+
+## Properties
+
+### artifactId
+
+> `readonly` **artifactId**: `string` \| `undefined`
+
+Defined in: [packages/release-maven/src/pom.ts:255](https://gitlab.com/wetryfun/release/release/-/blob/be2016d6f7c6f29592926b2f125da705da6376eb/packages/release-maven/src/pom.ts#L255)
+
+Its `artifactId`.
+
+***
+
+### groupId
+
+> `readonly` **groupId**: `string` \| `undefined`
+
+Defined in: [packages/release-maven/src/pom.ts:253](https://gitlab.com/wetryfun/release/release/-/blob/be2016d6f7c6f29592926b2f125da705da6376eb/packages/release-maven/src/pom.ts#L253)
+
+Its `groupId`.
+
+***
+
+### version
+
+> `readonly` **version**: `string` \| `undefined`
+
+Defined in: [packages/release-maven/src/pom.ts:257](https://gitlab.com/wetryfun/release/release/-/blob/be2016d6f7c6f29592926b2f125da705da6376eb/packages/release-maven/src/pom.ts#L257)
+
+Its `version`, as written.

package/api/@wtf/release-maven/pom/interfaces/PomPlugin.md

@@ -0,0 +1,51 @@
+[**Release trains**](../../../../README.md)
+
+***
+
+[Release trains](../../../../README.md) / [@wtf/release-maven/pom](../README.md) / PomPlugin
+
+# Interface: PomPlugin
+
+Defined in: [packages/release-maven/src/pom.ts:239](https://gitlab.com/wetryfun/release/release/-/blob/be2016d6f7c6f29592926b2f125da705da6376eb/packages/release-maven/src/pom.ts#L239)
+
+A plugin of the build of a pom, as it writes it.
+
+## Properties
+
+### artifactId
+
+> `readonly` **artifactId**: `string` \| `undefined`
+
+Defined in: [packages/release-maven/src/pom.ts:243](https://gitlab.com/wetryfun/release/release/-/blob/be2016d6f7c6f29592926b2f125da705da6376eb/packages/release-maven/src/pom.ts#L243)
+
+Its `artifactId`.
+
+***
+
+### dependencies
+
+> `readonly` **dependencies**: readonly [`PomDependency`](PomDependency.md)[]
+
+Defined in: [packages/release-maven/src/pom.ts:247](https://gitlab.com/wetryfun/release/release/-/blob/be2016d6f7c6f29592926b2f125da705da6376eb/packages/release-maven/src/pom.ts#L247)
+
+The dependencies of the plugin.
+
+***
+
+### groupId
+
+> `readonly` **groupId**: `string`
+
+Defined in: [packages/release-maven/src/pom.ts:241](https://gitlab.com/wetryfun/release/release/-/blob/be2016d6f7c6f29592926b2f125da705da6376eb/packages/release-maven/src/pom.ts#L241)
+
+Its `groupId`: `org.apache.maven.plugins` where it writes none, as Maven reads it.
+
+***
+
+### version
+
+> `readonly` **version**: `string` \| `undefined`
+
+Defined in: [packages/release-maven/src/pom.ts:245](https://gitlab.com/wetryfun/release/release/-/blob/be2016d6f7c6f29592926b2f125da705da6376eb/packages/release-maven/src/pom.ts#L245)
+
+Its `version`, as written.

package/api/@wtf/release-maven/pom/interfaces/PomRepository.md

@@ -0,0 +1,31 @@
+[**Release trains**](../../../../README.md)
+
+***
+
+[Release trains](../../../../README.md) / [@wtf/release-maven/pom](../README.md) / PomRepository
+
+# Interface: PomRepository
+
+Defined in: [packages/release-maven/src/pom.ts:261](https://gitlab.com/wetryfun/release/release/-/blob/be2016d6f7c6f29592926b2f125da705da6376eb/packages/release-maven/src/pom.ts#L261)
+
+The repository a pom deploys to, of its `distributionManagement`.
+
+## Properties
+
+### id
+
+> `readonly` **id**: `string` \| `undefined`
+
+Defined in: [packages/release-maven/src/pom.ts:263](https://gitlab.com/wetryfun/release/release/-/blob/be2016d6f7c6f29592926b2f125da705da6376eb/packages/release-maven/src/pom.ts#L263)
+
+Its `id`, the `<server>` of settings.xml whose credentials Maven deploys by.
+
+***
+
+### url
+
+> `readonly` **url**: `string` \| `undefined`
+
+Defined in: [packages/release-maven/src/pom.ts:265](https://gitlab.com/wetryfun/release/release/-/blob/be2016d6f7c6f29592926b2f125da705da6376eb/packages/release-maven/src/pom.ts#L265)
+
+Its `url`, as written, as `${env.CI_API_V4_URL}/projects/1/packages/maven`.

package/api/@wtf/release-maven/pom/interfaces/Span.md

@@ -0,0 +1,35 @@
+[**Release trains**](../../../../README.md)
+
+***
+
+[Release trains](../../../../README.md) / [@wtf/release-maven/pom](../README.md) / Span
+
+# Interface: Span
+
+Defined in: [packages/release-maven/src/pom.ts:27](https://gitlab.com/wetryfun/release/release/-/blob/be2016d6f7c6f29592926b2f125da705da6376eb/packages/release-maven/src/pom.ts#L27)
+
+Where a part of the text starts and ends: `end` is the offset after its last character.
+
+## Extended by
+
+- [`XmlElement`](XmlElement.md)
+
+## Properties
+
+### end
+
+> `readonly` **end**: `number`
+
+Defined in: [packages/release-maven/src/pom.ts:31](https://gitlab.com/wetryfun/release/release/-/blob/be2016d6f7c6f29592926b2f125da705da6376eb/packages/release-maven/src/pom.ts#L31)
+
+The offset after its last character.
+
+***
+
+### start
+
+> `readonly` **start**: `number`
+
+Defined in: [packages/release-maven/src/pom.ts:29](https://gitlab.com/wetryfun/release/release/-/blob/be2016d6f7c6f29592926b2f125da705da6376eb/packages/release-maven/src/pom.ts#L29)
+
+The offset of its first character.

package/api/@wtf/release-maven/pom/interfaces/XmlElement.md

@@ -0,0 +1,83 @@
+[**Release trains**](../../../../README.md)
+
+***
+
+[Release trains](../../../../README.md) / [@wtf/release-maven/pom](../README.md) / XmlElement
+
+# Interface: XmlElement
+
+Defined in: [packages/release-maven/src/pom.ts:35](https://gitlab.com/wetryfun/release/release/-/blob/be2016d6f7c6f29592926b2f125da705da6376eb/packages/release-maven/src/pom.ts#L35)
+
+An element of XML, as [parseXml](../functions/parseXml.md) reads it.
+
+## Extends
+
+- [`Span`](Span.md)
+
+## Properties
+
+### children
+
+> `readonly` **children**: readonly `XmlElement`[]
+
+Defined in: [packages/release-maven/src/pom.ts:41](https://gitlab.com/wetryfun/release/release/-/blob/be2016d6f7c6f29592926b2f125da705da6376eb/packages/release-maven/src/pom.ts#L41)
+
+Its elements, in order.
+
+***
+
+### end
+
+> `readonly` **end**: `number`
+
+Defined in: [packages/release-maven/src/pom.ts:31](https://gitlab.com/wetryfun/release/release/-/blob/be2016d6f7c6f29592926b2f125da705da6376eb/packages/release-maven/src/pom.ts#L31)
+
+The offset after its last character.
+
+#### Inherited from
+
+[`Span`](Span.md).[`end`](Span.md#end)
+
+***
+
+### inner
+
+> `readonly` **inner**: [`Span`](Span.md) \| `undefined`
+
+Defined in: [packages/release-maven/src/pom.ts:39](https://gitlab.com/wetryfun/release/release/-/blob/be2016d6f7c6f29592926b2f125da705da6376eb/packages/release-maven/src/pom.ts#L39)
+
+Where its content is, between its tags: `undefined` of an element of one tag, as `<version/>`.
+
+***
+
+### name
+
+> `readonly` **name**: `string`
+
+Defined in: [packages/release-maven/src/pom.ts:37](https://gitlab.com/wetryfun/release/release/-/blob/be2016d6f7c6f29592926b2f125da705da6376eb/packages/release-maven/src/pom.ts#L37)
+
+Its name, as its tag writes it, as `version`.
+
+***
+
+### start
+
+> `readonly` **start**: `number`
+
+Defined in: [packages/release-maven/src/pom.ts:29](https://gitlab.com/wetryfun/release/release/-/blob/be2016d6f7c6f29592926b2f125da705da6376eb/packages/release-maven/src/pom.ts#L29)
+
+The offset of its first character.
+
+#### Inherited from
+
+[`Span`](Span.md).[`start`](Span.md#start)
+
+***
+
+### text
+
+> `readonly` **text**: `string`
+
+Defined in: [packages/release-maven/src/pom.ts:43](https://gitlab.com/wetryfun/release/release/-/blob/be2016d6f7c6f29592926b2f125da705da6376eb/packages/release-maven/src/pom.ts#L43)
+
+Its own text, and of its CDATA, the entities read, of no space at either end: not its children's.

package/api/@wtf/release-maven/pom/variables/PLUGIN_GROUP.md

@@ -0,0 +1,13 @@
+[**Release trains**](../../../../README.md)
+
+***
+
+[Release trains](../../../../README.md) / [@wtf/release-maven/pom](../README.md) / PLUGIN\_GROUP
+
+# Variable: PLUGIN\_GROUP
+
+> `const` **PLUGIN\_GROUP**: `"org.apache.maven.plugins"` = `'org.apache.maven.plugins'`
+
+Defined in: [packages/release-maven/src/pom.ts:301](https://gitlab.com/wetryfun/release/release/-/blob/be2016d6f7c6f29592926b2f125da705da6376eb/packages/release-maven/src/pom.ts#L301)
+
+The groupId of a plugin that writes none, as Maven reads it.

package/api/@wtf/release-maven/publish/README.md

@@ -0,0 +1,45 @@
+[**Release trains**](../../../README.md)
+
+***
+
+[Release trains](../../../README.md) / @wtf/release-maven/publish
+
+# @wtf/release-maven/publish
+
+The modules of a release deployed, by `mvn` run through the system from the root of the repo:
+each module the repository has not at the version, in the order it is given, the ones it has
+skipped, so a release that failed part way is finished by running it again. Each runs
+`<command> -B -N -f <dir>/pom.xml deploy`, of that pom alone: a deploy installs the module into
+the local repository too, so the next module of the release finds it. A module the release does
+not deploy that one of it needs, as a module of `maven.deploy.skip` its tests depend on, is
+installed in its place in the order (`install` for `deploy`).
+
+```ts
+import { deployModules } from '@wtf/release-maven/publish'
+import type { MavenModule } from '@wtf/release-maven'
+import type { System } from '@wtf/release-system'
+
+// The modules deployed, of a repository that has none of them yet.
+export const deployAll = (system: System, modules: MavenModule[]) =>
+  deployModules({
+    system,
+    cwd: system.cwd,
+    modules,
+    version: '1.0.0',
+    lookup: async () => false,
+    log: console.log
+  })
+```
+
+## Interfaces
+
+- [DeployedModule](interfaces/DeployedModule.md)
+- [DeployModulesOptions](interfaces/DeployModulesOptions.md)
+
+## Type Aliases
+
+- [ModuleStatus](type-aliases/ModuleStatus.md)
+
+## Functions
+
+- [deployModules](functions/deployModules.md)

package/api/@wtf/release-maven/publish/functions/deployModules.md

@@ -0,0 +1,35 @@
+[**Release trains**](../../../../README.md)
+
+***
+
+[Release trains](../../../../README.md) / [@wtf/release-maven/publish](../README.md) / deployModules
+
+# Function: deployModules()
+
+> **deployModules**(`options`): `Promise`\<[`DeployedModule`](../interfaces/DeployedModule.md)[]\>
+
+Defined in: [packages/release-maven/src/publish.ts:110](https://gitlab.com/wetryfun/release/release/-/blob/be2016d6f7c6f29592926b2f125da705da6376eb/packages/release-maven/src/publish.ts#L110)
+
+Deploys each module of the release the repository lacks, in order, and gives what became of each.
+The repository is asked of every module before the first is deployed, so one it cannot answer of
+stops the run before anything is on it. A version that is there is skipped.
+
+## Parameters
+
+### options
+
+[`DeployModulesOptions`](../interfaces/DeployModulesOptions.md)
+
+The system, the modules and the version, the lookup, the command and its
+arguments, the repository and the log.
+
+## Returns
+
+`Promise`\<[`DeployedModule`](../interfaces/DeployedModule.md)[]\>
+
+The modules, in the order given, each deployed, skipped or installed.
+
+## Throws
+
+`EMAVENREPOSITORY` of a repository that cannot be asked, `EMAVENDEPLOY` of an `mvn` that
+cannot be run or fails.

package/api/@wtf/release-maven/publish/interfaces/DeployModulesOptions.md

@@ -0,0 +1,146 @@
+[**Release trains**](../../../../README.md)
+
+***
+
+[Release trains](../../../../README.md) / [@wtf/release-maven/publish](../README.md) / DeployModulesOptions
+
+# Interface: DeployModulesOptions
+
+Defined in: [packages/release-maven/src/publish.ts:53](https://gitlab.com/wetryfun/release/release/-/blob/be2016d6f7c6f29592926b2f125da705da6376eb/packages/release-maven/src/publish.ts#L53)
+
+What a deploy needs.
+
+## Properties
+
+### args?
+
+> `readonly` `optional` **args?**: readonly `string`[]
+
+Defined in: [packages/release-maven/src/publish.ts:81](https://gitlab.com/wetryfun/release/release/-/blob/be2016d6f7c6f29592926b2f125da705da6376eb/packages/release-maven/src/publish.ts#L81)
+
+The arguments of each run after the goal, as `['-s', 'ci_settings.xml']`.
+
+***
+
+### command?
+
+> `readonly` `optional` **command?**: `string`
+
+Defined in: [packages/release-maven/src/publish.ts:79](https://gitlab.com/wetryfun/release/release/-/blob/be2016d6f7c6f29592926b2f125da705da6376eb/packages/release-maven/src/publish.ts#L79)
+
+Maven, as it is run: `mvn` by default, or a wrapper, as `./mvnw`.
+
+***
+
+### cwd
+
+> `readonly` **cwd**: `string`
+
+Defined in: [packages/release-maven/src/publish.ts:57](https://gitlab.com/wetryfun/release/release/-/blob/be2016d6f7c6f29592926b2f125da705da6376eb/packages/release-maven/src/publish.ts#L57)
+
+The folder of the repo, where `mvn` runs.
+
+***
+
+### installs?
+
+> `readonly` `optional` **installs?**: `ReadonlySet`\<`string`\>
+
+Defined in: [packages/release-maven/src/publish.ts:67](https://gitlab.com/wetryfun/release/release/-/blob/be2016d6f7c6f29592926b2f125da705da6376eb/packages/release-maven/src/publish.ts#L67)
+
+The modules of `modules` to install rather than deploy, by name (`installsOf` of
+`./artifacts`): none by default.
+
+***
+
+### log
+
+> `readonly` **log**: (`line`) => `void`
+
+Defined in: [packages/release-maven/src/publish.ts:92](https://gitlab.com/wetryfun/release/release/-/blob/be2016d6f7c6f29592926b2f125da705da6376eb/packages/release-maven/src/publish.ts#L92)
+
+The log of the run, a line at a time.
+
+#### Parameters
+
+##### line
+
+`string`
+
+The line to log, of no newline.
+
+#### Returns
+
+`void`
+
+***
+
+### lookup
+
+> `readonly` **lookup**: (`module`, `version`) => `Promise`\<`boolean`\>
+
+Defined in: [packages/release-maven/src/publish.ts:77](https://gitlab.com/wetryfun/release/release/-/blob/be2016d6f7c6f29592926b2f125da705da6376eb/packages/release-maven/src/publish.ts#L77)
+
+Whether the repository has a module at a version: the plugin asks it for its pom.
+
+#### Parameters
+
+##### module
+
+[`MavenModule`](../../interfaces/MavenModule.md)
+
+The module.
+
+##### version
+
+`string`
+
+The version.
+
+#### Returns
+
+`Promise`\<`boolean`\>
+
+Whether the repository has it.
+
+***
+
+### modules
+
+> `readonly` **modules**: readonly [`MavenModule`](../../interfaces/MavenModule.md)[]
+
+Defined in: [packages/release-maven/src/publish.ts:62](https://gitlab.com/wetryfun/release/release/-/blob/be2016d6f7c6f29592926b2f125da705da6376eb/packages/release-maven/src/publish.ts#L62)
+
+The modules, in the order to deploy them in (`publishOrder` of `./artifacts`), at `version`
+already.
+
+***
+
+### repository?
+
+> `readonly` `optional` **repository?**: [`Repository`](../../repository/interfaces/Repository.md)
+
+Defined in: [packages/release-maven/src/publish.ts:86](https://gitlab.com/wetryfun/release/release/-/blob/be2016d6f7c6f29592926b2f125da705da6376eb/packages/release-maven/src/publish.ts#L86)
+
+The repository each module deploys to, of the plugin's options, as `altDeploymentRepository`:
+none, each deploys to its pom's `distributionManagement`.
+
+***
+
+### system
+
+> `readonly` **system**: [`System`](../../../release-system/system/interfaces/System.md)
+
+Defined in: [packages/release-maven/src/publish.ts:55](https://gitlab.com/wetryfun/release/release/-/blob/be2016d6f7c6f29592926b2f125da705da6376eb/packages/release-maven/src/publish.ts#L55)
+
+The system `mvn` runs by: its environment holds what the settings of Maven read.
+
+***
+
+### version
+
+> `readonly` **version**: `string`
+
+Defined in: [packages/release-maven/src/publish.ts:69](https://gitlab.com/wetryfun/release/release/-/blob/be2016d6f7c6f29592926b2f125da705da6376eb/packages/release-maven/src/publish.ts#L69)
+
+The version of the release.

package/api/@wtf/release-maven/publish/interfaces/DeployedModule.md

@@ -0,0 +1,42 @@
+[**Release trains**](../../../../README.md)
+
+***
+
+[Release trains](../../../../README.md) / [@wtf/release-maven/publish](../README.md) / DeployedModule
+
+# Interface: DeployedModule
+
+Defined in: [packages/release-maven/src/publish.ts:40](https://gitlab.com/wetryfun/release/release/-/blob/be2016d6f7c6f29592926b2f125da705da6376eb/packages/release-maven/src/publish.ts#L40)
+
+A module of the release, and what became of it.
+
+## Properties
+
+### name
+
+> `readonly` **name**: `string`
+
+Defined in: [packages/release-maven/src/publish.ts:42](https://gitlab.com/wetryfun/release/release/-/blob/be2016d6f7c6f29592926b2f125da705da6376eb/packages/release-maven/src/publish.ts#L42)
+
+The name of the module, `groupId:artifactId`.
+
+***
+
+### status
+
+> `readonly` **status**: [`ModuleStatus`](../type-aliases/ModuleStatus.md)
+
+Defined in: [packages/release-maven/src/publish.ts:49](https://gitlab.com/wetryfun/release/release/-/blob/be2016d6f7c6f29592926b2f125da705da6376eb/packages/release-maven/src/publish.ts#L49)
+
+Whether it was deployed, skipped as the repository has it, or installed alone, as a module the
+release does not deploy.
+
+***
+
+### version
+
+> `readonly` **version**: `string`
+
+Defined in: [packages/release-maven/src/publish.ts:44](https://gitlab.com/wetryfun/release/release/-/blob/be2016d6f7c6f29592926b2f125da705da6376eb/packages/release-maven/src/publish.ts#L44)
+
+The version of the module: the release's, but of a module installed of another.

package/api/@wtf/release-maven/publish/type-aliases/ModuleStatus.md

@@ -0,0 +1,13 @@
+[**Release trains**](../../../../README.md)
+
+***
+
+[Release trains](../../../../README.md) / [@wtf/release-maven/publish](../README.md) / ModuleStatus
+
+# Type Alias: ModuleStatus
+
+> **ModuleStatus** = `"deployed"` \| `"skipped"` \| `"installed"`
+
+Defined in: [packages/release-maven/src/publish.ts:37](https://gitlab.com/wetryfun/release/release/-/blob/be2016d6f7c6f29592926b2f125da705da6376eb/packages/release-maven/src/publish.ts#L37)
+
+What happened to a module of the release.

package/api/@wtf/release-maven/repository/README.md

@@ -0,0 +1,38 @@
+[**Release trains**](../../../README.md)
+
+***
+
+[Release trains](../../../README.md) / @wtf/release-maven/repository
+
+# @wtf/release-maven/repository
+
+Where a Maven repository serves a module, of no network: the path of a pom in the layout of a
+repository ([pomPath](functions/pomPath.md)) and its URL ([pomUrl](functions/pomUrl.md)), what an answer to a request of it says
+([hasPom](functions/hasPom.md)), the values of `${…}` in a URL a pom writes ([expandValues](functions/expandValues.md)), and the
+repository each module of a release deploys to ([deployTargets](functions/deployTargets.md)). The caller asks the
+repository; a release asks Maven Central at [MAVEN\_CENTRAL](variables/MAVEN_CENTRAL.md), where the Central Portal
+publishes.
+
+```ts
+import { pomUrl } from '@wtf/release-maven/repository'
+
+console.log(pomUrl('https://repo1.maven.org/maven2', 'org.acme', 'core', '1.2.3'))
+// https://repo1.maven.org/maven2/org/acme/core/1.2.3/core-1.2.3.pom
+```
+
+## Interfaces
+
+- [Repository](interfaces/Repository.md)
+- [ValuesOf](interfaces/ValuesOf.md)
+
+## Variables
+
+- [MAVEN\_CENTRAL](variables/MAVEN_CENTRAL.md)
+
+## Functions
+
+- [deployTargets](functions/deployTargets.md)
+- [expandValues](functions/expandValues.md)
+- [hasPom](functions/hasPom.md)
+- [pomPath](functions/pomPath.md)
+- [pomUrl](functions/pomUrl.md)