-
Notifications
You must be signed in to change notification settings - Fork 36
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
Merge branch 'main' into request-redemption-in-one-tx
- Loading branch information
Showing
14 changed files
with
2,748 additions
and
541 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,89 @@ | ||
| name: Solidity docs | ||
|
|
||
| on: | ||
| pull_request: | ||
| push: | ||
| branches: | ||
| - releases/mainnet/solidity/** | ||
| release: | ||
| types: | ||
| - "published" | ||
| workflow_dispatch: | ||
|
|
||
| jobs: | ||
| docs-detect-changes: | ||
| runs-on: ubuntu-latest | ||
| outputs: | ||
| path-filter: ${{ steps.filter.outputs.path-filter }} | ||
| steps: | ||
| - uses: actions/checkout@v3 | ||
| if: github.event_name == 'pull_request' | ||
| - uses: dorny/paths-filter@v2 | ||
| if: github.event_name == 'pull_request' | ||
| id: filter | ||
| with: | ||
| filters: | | ||
| path-filter: | ||
| - './solidity/contracts/**' | ||
| - './.github/workflows/contracts-docs.yml' | ||
| # This job will be triggered for PRs which modify contracts. It will generate | ||
| # the archive with contracts documentation in Markdown and attatch it to the | ||
| # workflow run results. Link to the archive will be posted in a PR comment. | ||
| # The job will also be run after manual triggering and after pushes to the | ||
| # `releases/mainnet/solidity/**` branches. | ||
| contracts-docs-publish-preview: | ||
| name: Publish preview of contracts documentation | ||
| needs: docs-detect-changes | ||
| if: | | ||
| needs.docs-detect-changes.outputs.path-filter == 'true' | ||
| || github.event_name == 'push' | ||
| || github.event_name == 'workflow_dispatch' | ||
| uses: keep-network/ci/.github/workflows/reusable-solidity-docs.yml@main | ||
| with: | ||
| projectDir: /solidity | ||
| # We need to remove unnecessary `//` comment used in the `@dev` | ||
| # section of `BitcoinTx` documentation, which was causing problem with | ||
| # rendering of the `.md` file. We do that by executing | ||
| # `sed -i ':a;N;$!ba;s_///\n//\n_///\n_g'` on the problematic file. The | ||
| # command substitutes `///` + newline + `//` + newline with just `///` + | ||
| # newline and does this in a loop. | ||
| preProcessingCommand: sed -i ':a;N;$!ba;s_///\n//\n_///\n_g' ./contracts/bridge/BitcoinTx.sol | ||
| publish: false | ||
| addTOC: false | ||
| commentPR: true | ||
| exportAsGHArtifacts: true | ||
|
|
||
| # This job will be triggered for releases which name starts with | ||
| # `refs/tags/solidity/`. It will generate contracts documentation in | ||
| # Markdown and sync it with a specific path of | ||
| # `threshold-network/threshold` repository. If changes will be detected, | ||
| # a PR updating the docs will be created in the destination repository. The | ||
| # commit pushing the changes will be verified using GPG key. | ||
| contracts-docs-publish: | ||
| name: Publish contracts documentation | ||
| needs: docs-detect-changes | ||
| if: github.event_name == 'release' && startsWith(github.ref, 'refs/tags/solidity/') | ||
| uses: keep-network/ci/.github/workflows/reusable-solidity-docs.yml@main | ||
| with: | ||
| projectDir: /solidity | ||
| # We need to remove unnecessary `//` comment used in the `@dev` | ||
| # section of `BitcoinTx` documentation, which was causing problem with | ||
| # rendering of the `.md` file. We do that by executing | ||
| # `sed -i ':a;N;$!ba;s_///\n//\n_///\n_g'` on the problematic file. The | ||
| # command substitutes `///` + newline + `//` + newline with just `///` + | ||
| # newline and does this in a loop. | ||
| preProcessingCommand: sed -i ':a;N;$!ba;s_///\n//\n_///\n_g' ./contracts/bridge/BitcoinTx.sol | ||
| publish: true | ||
| addTOC: false | ||
| verifyCommits: true | ||
| destinationRepo: threshold-network/threshold | ||
| destinationFolder: ./docs/app-development/tbtc-v2/tbtc-v2-api | ||
| destinationBaseBranch: main | ||
| userEmail: 38324465+thesis-valkyrie@users.noreply.github.com | ||
| userName: Valkyrie | ||
| rsyncDelete: true | ||
| secrets: | ||
| githubToken: ${{ secrets.THRESHOLD_DOCS_GITHUB_TOKEN }} | ||
| gpgPrivateKey: ${{ secrets.THRESHOLD_DOCS_GPG_PRIVATE_KEY_BASE64 }} | ||
| gpgPassphrase: ${{ secrets.THRESHOLD_DOCS_GPG_PASSPHRASE }} |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
|
|
@@ -6,4 +6,5 @@ deployments/ | |
| export/ | ||
| hardhat-dependency-compiler/ | ||
| typechain/ | ||
| docgen-templates/ | ||
| export.json | ||
Oops, something went wrong.