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

[Soroban Merge] Create a "Platforms" section #325

Merged
merged 147 commits into from
Mar 5, 2024

Conversation

ElliotFriend
Copy link
Contributor

@ElliotFriend ElliotFriend commented Feb 28, 2024

This PR adds a "Platforms" navbar item, that drops down to include Horizon, SDP, Anchor Platform. I've also moved the "Admin Guides" from the /docs section into these respective sections so as to keep everything together.

Still some work to do:

  • Soroban-RPC should be moved over here from soroban.stellar.org
  • We use a custom ApiItem as the docItemComponent for the auto-generated openapi pages, but it looks less than good for those admin guide pages. We could probably just add some logic to that ApiItem component to ignore them?
  • nginx redirects haven't been added/updated yet
  • make sure the scripts in package.json are properly written to reflect new filepaths
    • test to make sure the redocly things build properly still

Refs: stellar-deprecated/soroban-docs#757

ElliotFriend and others added 30 commits January 24, 2023 07:39
* Adding the `/api` route to the config, and basic intro content

For the moment, I'm essentially copying from the Google Doc.

Signed-off-by: Elliot Voris <[email protected]>

* Adding content for the `getAccount` method

Stubbing in basic file structure for all other methods.

Signed-off-by: Elliot Voris <[email protected]>

* Expanding the methods in the sidebar by default

Signed-off-by: Elliot Voris <[email protected]>

* Adding content for `getHealth` method

Signed-off-by: Elliot Voris <[email protected]>

* Adding content for the `getHealth` method

Signed-off-by: Elliot Voris <[email protected]>

* Adding content for the `getLatestLedger` method

Signed-off-by: Elliot Voris <[email protected]>

* Adding content for the `getLedgerEntry` method

Signed-off-by: Elliot Voris <[email protected]>

* Adding content for the `getContractData` method

Signed-off-by: Elliot Voris <[email protected]>

* Adding content for the `getEvents` method

Signed-off-by: Elliot Voris <[email protected]>

* Un-commenting a TODO item

Signed-off-by: Elliot Voris <[email protected]>

* Adding content for the `getNetwork` method

Signed-off-by: Elliot Voris <[email protected]>

* Adding content for the `getTransactionStatus` method

Signed-off-by: Elliot Voris <[email protected]>

* Adding content for the `requestAirdrop` method

Signed-off-by: Elliot Voris <[email protected]>

* Adding content for the `sendTransaction` method

Signed-off-by: Elliot Voris <[email protected]>

* Adding content for `simulateTransaction` method

Signed-off-by: Elliot Voris <[email protected]>

* Changing the appearance of a WIP note

Signed-off-by: Elliot Voris <[email protected]>

* Breaking each of the intro sections into their own pages

Signed-off-by: Elliot Voris <[email protected]>

* Hand-writing (most) of the sidebar

It's easier to accomplish what I'm after this way. Or, at least,
I figured out how to accomplish it this way first.

Signed-off-by: Elliot Voris <[email protected]>

* Adding a "description" field to the intro category

Signed-off-by: Elliot Voris <[email protected]>

* Fixing a link reference to `pagination`

Signed-off-by: Elliot Voris <[email protected]>

* Capitalizing `Stellar` more consistently

Signed-off-by: Elliot Voris <[email protected]>

* Update api/methods/getEvents.mdx

Soroban-RPC supports querying up to 24 hours of recent ledgers.

Co-authored-by: Paul Bellamy <[email protected]>

* Update api/methods/getTransactionStatus.mdx

Co-authored-by: Paul Bellamy <[email protected]>

* `sendTransaction` *does* support all Stellar transactions.

Signed-off-by: Elliot Voris <[email protected]>

* Removing the question about auto-calculating footprints

Signed-off-by: Elliot Voris <[email protected]>

* All questions have been answered. Sweet!!

Signed-off-by: Elliot Voris <[email protected]>

* Update api/pagination.mdx

Co-authored-by: Paul Bellamy <[email protected]>

* Removing the "Outstanding Questions" page from the sidebar

Signed-off-by: Elliot Voris <[email protected]>

* denoting `getNetwork` as a work-in-progress

Signed-off-by: Elliot Voris <[email protected]>

* Moving the (WIP) methods to their own sidebar section

Signed-off-by: Elliot Voris <[email protected]>

* Adding example request/response to the `getAccount` method

Signed-off-by: Elliot Voris <[email protected]>

* Adding example request/response for the `getHealth` method

Signed-off-by: Elliot Voris <[email protected]>

* Adding example request/response for the `sendTransaction` method

Signed-off-by: Elliot Voris <[email protected]>

* Adding example request/response for the `getTransactionStatus` method

Signed-off-by: Elliot Voris <[email protected]>

* Adding example request/response for the `getContractData` method

Signed-off-by: Elliot Voris <[email protected]>

* Adding example request/response for the `getLedgerEntry` method

Signed-off-by: Elliot Voris <[email protected]>

* Changing the `balance` field into a "TODO"

Signed-off-by: Elliot Voris <[email protected]>

* Adding example request/response for the `getEvents` method

Signed-off-by: Elliot Voris <[email protected]>

* Adding a note about the events that are returned

Signed-off-by: Elliot Voris <[email protected]>

* Adding example request/response for the `simulateTransaction` method.

Signed-off-by: Elliot Voris <[email protected]>

* Adding a pending example to the `getTransactionStatus` method

Signed-off-by: Elliot Voris <[email protected]>

* Adding a more useful success example to `getTransactionStatus`

Signed-off-by: Elliot Voris <[email protected]>

* Using a soroban transaction in the `sendTransaction` method

Don't forget the footprint, friends!

Signed-off-by: Elliot Voris <[email protected]>

* Removing the `getContractData` method

This method is being deprecated. See stellar/stellar-cli#316 for
more details.

Please use the `getLedgerEntry` method instead.

Signed-off-by: Elliot Voris <[email protected]>

Signed-off-by: Elliot Voris <[email protected]>
Co-authored-by: Paul Bellamy <[email protected]>
…ry` (stellar#281)

* Providing a (long-winded?) example for retrieving contract code

Is this too detailed? Is this even needed?

Signed-off-by: Elliot Voris <[email protected]>

* Adding a link to lab to help with decoding XDR

Signed-off-by: Elliot Voris <[email protected]>

* Fine-tuning the explanation of the `ContractCode` LedgerEntry

Shuffling some things around a bit, and giving a better overview of
the contract deployment process for Soroban.

Co-authored-by: Paul Bellamy <[email protected]>
Signed-off-by: Elliot Voris <[email protected]>

Signed-off-by: Elliot Voris <[email protected]>
Co-authored-by: Paul Bellamy <[email protected]>
* Change SDK section to Reference section

* Adding JS SDK to list of SDKs

* Adding Overcat's Python SDK to list of SDKs

* Moving Networks -> Futurenet to Reference section

* Moving Releases to Reference section

* Delete Networks from main nav

Networks now lives under Reference section

* Deleting as Releases now live in Reference section

* Changing sidebar position

Temporary, this will eventually move to How-To Guides

* Update byo.mdx

* Edited Quick Start to 1. Hello World

Includes Tutorials -> Create a Project / Write a Contract / Test / Build / Run on Sandbox / Optimizing Builds

* Move Storing Data from Examples to Getting Started

* Move Deploy to Local Network to Getting Started

Moved this section from Tutorials to Getting Started

* Move Freighter wallet tutorial to Getting Started

* Update and rename 6.-connect-Freighter-wallet.mdx to 4. Connect Freighter Wallet

* Move Deploy to Futurenet to Getting Started

* Rename 4. Connect Freighter Wallet to 4. Connect Freighter Wallet.mdx

* Moved to Getting Started

* Moved to Getting Started

Removing this section

* Moved to Getting Started

Removing this as it has been moved to Getting Started

* Moved to Getting Started -> Hello World

* Moved to Getting Started -> Hello World

* Moved to Getting Started -> Hello World

* Moved to Getting Started -> Hello World

* Moved to Getting Started -> Hello World

* Moved to Getting Started -> Hello World

* Moved to Getting Started

Removing due to this section being moved

* Update Examples to How-To Guides

* Move BYO SDK to How-To Guides

* Moved to How-To Guides

* Moved invoking contracts with transactions to How-To Guides

* Removing because it's moved to How-To Guides

* Moved Token Interface to Token How-To Guide

* Remove Token Interface

Token Interface has been moved to How-To Guides -> Token

* Move Stellar Asset Contract to How-To Guides

* Delete docs/built-in-contracts directory

Moved to How-To Guides

* Move Stellar FAQs to Learn

* Delete faq.mdx

Moved to Learn

* Update authorization.mdx

Alphabetize sidebar

* Update contract-lifecycle.mdx

Alphabetizing sidebar

* Update custom-types.mdx

Alphabetizing sidebar

* Update rust-dialect.mdx

Alphabetizing sidebar

* Update debugging.mdx

Alphabetizing sidebar

* Update environment-concepts.mdx

Alphabetizing sidebar

* Update errors.mdx

Alphabetizing sidebar

* Update events.mdx

Alphabetizing sidebar

* Update gas-and-metering.mdx

Alphabetizing sidebar

* Update interacting-with-contracts.mdx

Alphabetizing sidebar

* Update persisting-data.mdx

Alphabetizing sidebar

* Update high-level-overview.mdx

Update spelling

* formatting

* formatting

* formatting

* formatting

* Update faq.mdx

* fixed broken links

* fix broken links

* fix broken links

* moar link fixes

* fixed some broken links

* added sorobanathon homepage

* add google tag manager

* Content edits made

* back to original

* Content Edit

* button location

* Content & Eligibility guidelines added

* Update sorobanathon.js

* update all admonitions such that prettier doesn't yell

* Lots of formatting

* --prose-wrap preserve

* Update releases.mdx

* update prettier

* fixed the callouts

* formatting

* fix module import

* Update sorobanathon.js

* Fixed Reorg PR

Fixed links, moved sections, deleted double sections

* Update index.js

* Updating Sorobanathon Info

* Fixed links

Many links.

* Formatting

* Change SDK section to Reference section

* Adding JS SDK to list of SDKs

* Adding Overcat's Python SDK to list of SDKs

* Moving Networks -> Futurenet to Reference section

* Moving Releases to Reference section

* Delete Networks from main nav

Networks now lives under Reference section

* Deleting as Releases now live in Reference section

* Changing sidebar position

Temporary, this will eventually move to How-To Guides

* Update byo.mdx

* formatting

* fix broken links

* Edited Quick Start to 1. Hello World

Includes Tutorials -> Create a Project / Write a Contract / Test / Build / Run on Sandbox / Optimizing Builds

* Move Storing Data from Examples to Getting Started

* Move Deploy to Local Network to Getting Started

Moved this section from Tutorials to Getting Started

* Move Freighter wallet tutorial to Getting Started

* Update and rename 6.-connect-Freighter-wallet.mdx to 4. Connect Freighter Wallet

* Move Deploy to Futurenet to Getting Started

* Rename 4. Connect Freighter Wallet to 4. Connect Freighter Wallet.mdx

* Moved to Getting Started

Removing this as it has been moved to Getting Started

* Moved to Getting Started -> Hello World

* Moved to Getting Started -> Hello World

* formatting

* fix broken links

* moar link fixes

* Update Examples to How-To Guides

* Move BYO SDK to How-To Guides

* Moved invoking contracts with transactions to How-To Guides

* Moved Token Interface to Token How-To Guide

* Remove Token Interface

Token Interface has been moved to How-To Guides -> Token

* Move Stellar Asset Contract to How-To Guides

* Delete docs/built-in-contracts directory

Moved to How-To Guides

* formatting

* fixed broken links

* Move Stellar FAQs to Learn

* Update authorization.mdx

Alphabetize sidebar

* Update contract-lifecycle.mdx

Alphabetizing sidebar

* Update custom-types.mdx

Alphabetizing sidebar

* Update rust-dialect.mdx

Alphabetizing sidebar

* Update debugging.mdx

Alphabetizing sidebar

* Update environment-concepts.mdx

Alphabetizing sidebar

* Update errors.mdx

Alphabetizing sidebar

* Update events.mdx

Alphabetizing sidebar

* Update gas-and-metering.mdx

Alphabetizing sidebar

* Update interacting-with-contracts.mdx

Alphabetizing sidebar

* Update persisting-data.mdx

Alphabetizing sidebar

* Update high-level-overview.mdx

Update spelling

* formatting

* Update faq.mdx

* fixed some broken links

* Update releases.mdx

* update prettier

* fixed the callouts

* formatting

* fix module import

* Fixed Reorg PR

Fixed links, moved sections, deleted double sections

* Fixed links

Many links.

* Formatting

* Merge cleanup

* More cleanup

* Formatting

* some small design tweaks

* copy tweaks

---------

Co-authored-by: Bri <[email protected]>
Co-authored-by: Anuxhya <[email protected]>
In stellar/stellar-cli#385 we modified the getEvents endpoint to remove the endLedger param and changed the behavior of pagination
* proposed auth-next support for simulateTransaction method

* Add note about multiple results

* auth is an array

* Updated example docs for Auth Next. (stellar#306)

* Updated example docs for Auth Next.

* Update token documentation for Auth Next (stellar#307)

* Update token doc to use auth next.

* Add AUTH_REQUIRED section

* Mention set_auth and link to classic docs

* feat: update for upcoming CLI version

* feat: CLI reference page

* Update optimize contracts section (stellar#310)

* Update hello-world.mdx

* Update hello-world.mdx

* don't need to manually install wasm-opt via binaryen

* remove the -Z flags

* More Auth Next docs updates (stellar#311)

* Remove rust-auth.mdx

* Update authorization docs and `Address` type info.

* Added auth info to transactions doc.

* Added a document about migrating to auth next.

* Add some high-level docs for Auth Next preflight (stellar#312)

* Add some preflight information for Auth Next

* Update docs/reference/command-line.mdx

* Update docs/reference/releases.mdx

* Update docs/reference/releases.mdx

* Update simulateTransaction.mdx

* Update examples to point to 0.6.0

* Update releases page to current state

* Add change log for cli and rpc

* Added a note on the breaking auth changes to the release notes. (stellar#315)

---------

Co-authored-by: Paul Bellamy <[email protected]>
Co-authored-by: Siddharth Suresh <[email protected]>
Co-authored-by: Chad Ostrowski <[email protected]>
Co-authored-by: Willem Wyndham <[email protected]>
Co-authored-by: Tyler van der Hoeven <[email protected]>
Co-authored-by: Paul Bellamy <[email protected]>
* Add descriptions to docs that appear in generated category indexes.

* Add category indexes and descriptions for SDKs and interfaces

* Clean up descriptions of API documents.

* compile -> create

* remove apostrophe

* added oxford comma

* capitalization

* added oxford comma

---------

Co-authored-by: Bri <[email protected]>
Soroban-RPC updates for the release
…count

Remove the deprecated (and now removed) getAccount soroban-rpc method
api/methods: Updated getLatestLedger docs
…ellar#439)

* API: Update simulateTransaction RPC method to include fee support

* stop using the increment example

* Update api/methods/simulateTransaction.mdx

Co-authored-by: Paul Bellamy <[email protected]>

* Address review feedback

---------

Co-authored-by: Paul Bellamy <[email protected]>
* Update XDR in JSON examples
* replace `getLedgerEntry` by `getLedgerEntries`
* Update XDR in JSON examples
* replace `getLedgerEntry` by `getLedgerEntries`
* Change command recommended for building .wasm files for deployment (stellar#476)

* Fix logging example (stellar#481)

* Update docs with auth XDR changes. (stellar#483)

* Update docs with auth XDR changes.

* WASM->Wasm rename.

Wasm is the official abbreviation of WebAssembly.

* Typo fixes (stellar#484)

* Add fuzzing docs. (stellar#486)

* State expiration operations and token updates (stellar#485)

* Add docs for state expiration operations

* Updates

* update token

* Update custom account

* More token updates

* Update atomic swap

* More detailed state expiration docs (stellar#492)

* More fixes (stellar#489)

* More fixes

* Add approve warning

* Update releases page

* Fix link

* Update example links from 0.8.4 to 0.9.2

* fix link

* Fixed instance bump bug in docs (stellar#493)

---------

Co-authored-by: Dmytro Kozhevin <[email protected]>
Co-authored-by: Brian Anderson <[email protected]>
Co-authored-by: Siddharth Suresh <[email protected]>
Co-authored-by: Garand Tyson <[email protected]>
Co-authored-by: Julian Martinez <[email protected]>
* Change command recommended for building .wasm files for deployment (stellar#476)

* Fix logging example (stellar#481)

* Update docs with auth XDR changes. (stellar#483)

* Update docs with auth XDR changes.

* WASM->Wasm rename.

Wasm is the official abbreviation of WebAssembly.

* Typo fixes (stellar#484)

* Add fuzzing docs. (stellar#486)

* State expiration operations and token updates (stellar#485)

* Add docs for state expiration operations

* Updates

* update token

* Update custom account

* More token updates

* Update atomic swap

* More detailed state expiration docs (stellar#492)

* More fixes (stellar#489)

* More fixes

* Add approve warning

* Update releases page

* Fix link

* Update example links from 0.8.4 to 0.9.2

* fix link

* Fixed instance bump bug in docs (stellar#493)

---------

Co-authored-by: Dmytro Kozhevin <[email protected]>
Co-authored-by: Brian Anderson <[email protected]>
Co-authored-by: Siddharth Suresh <[email protected]>
Co-authored-by: Garand Tyson <[email protected]>
Co-authored-by: Julian Martinez <[email protected]>
* Add javascript example to get the WASM content

* Update to preview 10
@stellar-jenkins
Copy link

@stellar-jenkins
Copy link

@stellar-jenkins
Copy link

@stellar-jenkins
Copy link

@stellar-jenkins
Copy link

@stellar-jenkins
Copy link

@stellar-jenkins
Copy link

@stellar-jenkins
Copy link

@stellar-jenkins
Copy link

Something went wrong with PR preview build please check

@stellar-jenkins
Copy link

Copy link
Contributor

@kalepail kalepail left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

🥳

@stellar-jenkins
Copy link

@ElliotFriend ElliotFriend merged commit aae1682 into stellar:main Mar 5, 2024
2 checks passed
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.