Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

fix: Add docs for Smart Contracts #96

Merged
merged 50 commits into from
Dec 21, 2023
Merged

fix: Add docs for Smart Contracts #96

merged 50 commits into from
Dec 21, 2023

Conversation

nakul1010
Copy link
Contributor

@nakul1010 nakul1010 commented Nov 22, 2023

  • Add docs for smart contracts.
  • Add a py script that formats the smart contract doc according to docusaurus.
  • integrate it with github ci

Steps

  • Contratct docs build command forge doc --out docs/docs/contracts
  • Script to refactor forge docs with docusaurus python3 docs_reformat_scripts/forge_doc_reformat.py
  • Build docusaurus, command is mentioned in vercel here

Note:

@nakul1010 nakul1010 self-assigned this Nov 22, 2023
Copy link

vercel bot commented Nov 22, 2023

The latest updates on your projects. Learn more about Vercel for Git ↗︎

Name Status Preview Comments Updated (UTC)
bob ✅ Ready (Inspect) Visit Preview 💬 Add feedback Dec 21, 2023 0:27am

@nakul1010
Copy link
Contributor Author

nakul1010 commented Dec 6, 2023

@nud3l & @gregdhill need to push generated forge docs can't gitignore it otherwise docusaurus won't pick it up. But it will only commit docs if there are any changes to the smart contracts.

Ideally need to design and maintain foundry- docusaurus plugin similar to what hardhat has here
So that docs can be autogenerated as well as can be ignored in gitignore

@nakul1010 nakul1010 changed the title (WIP)fix: Add docs for Smart Contracts fix: Add docs for Smart Contracts Dec 6, 2023
@nakul1010 nakul1010 requested review from nud3l and gregdhill December 6, 2023 09:00
.github/workflows/test.yml Outdated Show resolved Hide resolved
nakul1010 and others added 4 commits December 13, 2023 14:58
…akul/feat_contract_docs

# Conflicts:
#	docs/docs/contracts/src/src/bridge/BitcoinTx.sol/library.BitcoinTx.md
#	docs/docs/contracts/src/src/bridge/BridgeState.sol/library.BridgeState.md
#	docs/docs/contracts/src/src/bridge/IRelay.sol/interface.IRelay.md
#	docs/docs/contracts/src/src/bridge/WitnessTx.sol/library.WitnessTx.md
#	docs/docs/contracts/src/src/faucet/Erc20Minter.sol/contract.Erc20Minter.md
#	docs/docs/contracts/src/src/faucet/Erc20Minter.sol/interface.Erc20Mintable.md
#	docs/docs/contracts/src/src/relay/LightRelay.sol/contract.LightRelay.md
#	docs/docs/contracts/src/src/relay/LightRelay.sol/interface.ILightRelay.md
#	docs/docs/contracts/src/src/relay/LightRelay.sol/library.RelayUtils.md
#	docs/docs/contracts/src/src/relay/LightRelay.sol/struct.Epoch.md
#	docs/docs/contracts/src/src/relay/TestLightRelay.sol/contract.TestLightRelay.md
#	docs/docs/contracts/src/src/swap/Bridge.sol/contract.Bridge.md
#	docs/docs/contracts/src/src/swap/Btc_Marketplace.sol/contract.BtcMarketPlace.md
#	docs/docs/contracts/src/src/swap/Marketplace.sol/contract.MarketPlace.md
#	docs/docs/contracts/src/src/swap/Wrapped.sol/contract.BobWrappedBtc.md
@nud3l nud3l merged commit 811440a into master Dec 21, 2023
2 checks passed
@nud3l nud3l deleted the nakul/feat_contract_docs branch December 21, 2023 00:30
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

4 participants