Skip to content

Commit

Permalink
update docs integration request doc (#454)
Browse files Browse the repository at this point in the history
  • Loading branch information
meganskye authored Oct 4, 2023
1 parent 6d6ddc4 commit 0385652
Show file tree
Hide file tree
Showing 3 changed files with 86 additions and 46 deletions.
78 changes: 78 additions & 0 deletions docs-integration-request.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,78 @@
---
title: Docs Integration Request Form
---

# Your Project Name

:::info
- Create a new branch of astar-docs for your update/addition.

- Within the new branch, copy and rename this file to something meaningful (ie: *projectname-oracle.md* or *widgetzyx-nft-api.md*) and move it to the most appropriate section of Astar docs. If you're unsure about where that might be in the end, please submit a PR anyways; we will find a home for it prior to merging.

- If your tutorial includes images or screenshots, which are **highly encouraged**, please add them to a new or existing `img` folder located within the same folder as your .md file, and link to them using the following:

At top of .md file add this exactly:

`import Figure from '/src/components/figure'`

and in reference to each image, as one example:

`<Figure caption="This is a picture of Cody McCodeface, Degen" src={require('./img/cody_mccodeface.png').default } width="100%"/>`

or another example without a caption; width reduced:

`<Figure src={require('./img/Alice_und_Bob_only_slimmer.png').default } width="65%"/>`

- When your document or tutorial is finished, submit a pull request to the [astar-docs](https://github.com/AstarNetwork/astar-docs) repo on Github. Thank you!
:::

## Introduction

Write a short description in just a few paragraphs about your solution and how Astar developers can leverage it.

#### Example:
GraphQL is a query language for APIs and a runtime for executing those queries with your existing data. It provides an efficient and powerful alternative to REST and offers significant advantages when dealing with complex data models.

GraphQL allows clients to define the structure of the responses they receive. This means that instead of receiving a fixed data structure from a server, clients can request specific data they need, leading to more efficient data loading and a reduction in data over-fetching.

## Prerequisites

List the prerequisites necessary to work with your solution. Mention all required libraries, SDKs, plugins, etc. and the corresponding versions that should be installed, in list format. Link to external documentation if necessary.

#### Example:
- The latest version of `[Node.js](https://link.to.download.com)`.
- Swanky v1.x.x.x.
- A local development node.
- Basic JavaScript knowledge.

## Getting started

Here you should provide a step-by step tutorial about how developers can use your solution on Astar.

### Step 1
### Step 2
### Step...

## Addresses/Endpoints

Here you can provide a list of Gateways, Endpoints, or any other supporting information, in list form. Feel free to change the name of this heading to something more appropriate, or remove it entirely.

## Troubleshooting
List common implementation issues, causes, and solutions.

#### Example:
**I receive Error *X* after running *Y***

This occurs due to *Z* which can be resolved by following *ABC.*

:::note
This *something* is for **advanced users**, only.
:::

:::danger
This *something* you **REALLY** don't want to do!!
:::

## Learn more

Here you can provide links to your own documentation and related resources.
16 changes: 8 additions & 8 deletions docs/getting-started.md
Original file line number Diff line number Diff line change
Expand Up @@ -4,16 +4,16 @@ sidebar_position: 1

# Getting Started

Astar is the largest smart contract platform in the Polkadot ecosystem, supporting both Wasm and EVM. While providing native access to the Polkadot ecosystem through it's parachain slot, Astar also has bridges into other major ecosystems, including [Ethereum][cbridge], [BSC][cbridge], Cosmos, Polygon, and more. Through the #Build2Earn program, Astar offers a basic income to dApp developers through inflation, and provides direct funding to projects through the Astar Incubation Program.
Astar is the largest smart contract platform in the Polkadot ecosystem, supporting both Wasm and EVM. While providing native access to the Polkadot ecosystem through it's parachain slot, Astar also has bridges into other major ecosystems, including [Ethereum][cbridge], [BSC][cbridge], Cosmos, Polygon, and more. Through the #Build2Earn program, Astar offers a basic income to dApp developers, and direct funding to projects through an *unstoppable grants* program.

## Overview of Docs

- [**Build**](/docs/build) gives you the resources you need to get started with building.
testing, deploying, and interacting with smart contracts on the network.
- [**EVM**](/docs/build/evm) dives deeper into EVM on Astar and explains how EVM contracts can interact with other non-EVM modules through [precompiles](https://docs.astar.network/docs/build/EVM/precompiles/).
- [**Wasm**](/docs/build/wasm) provides an overview of the [Wasm stack](https://docs.astar.network/docs/build/wasm/smart-contract-wasm) on Astar, [Wasm contract frameworks](/docs/build/wasm/dsls), and [Swanky Suite](/docs/build/wasm/swanky-suite/).
- [**Nodes**](/docs/build/nodes) explains how to run full nodes, collators, indexers, and everything you need to know related to infrastructure.
- [**XCM**](/docs/learn/interoperability/xcm) explains how XCM is used in Astar and also how developers can use it to interact with the rest of the Polkadot network.
- [**Integrations**](/docs/build/integrations/) provide relevant information about the wallets, indexers, and oracles that are integrated with the network.
- [**Build**](/docs/build) - Provides the resources you need to start building, testing, deploying, and interacting with smart contracts on Astar network.
- [**EVM**](/docs/build/evm) - Dives deeper into the EVM on Astar and explains how EVM smart contracts can interact with non-EVM modules and the Wasm virtual machine through [precompiles](https://docs.astar.network/docs/build/EVM/precompiles/).
- [**Wasm**](/docs/build/wasm) - Provides an overview of the [Wasm stack](https://docs.astar.network/docs/build/wasm/smart-contract-wasm) on Astar, [Wasm contract frameworks](/docs/build/wasm/dsls), and [Swanky Suite](/docs/build/wasm/swanky-suite/).
- [**Nodes**](/docs/build/nodes) - Explains how to run full nodes, collators, indexers, and everything else related to infrastructure.
- [**XCM**](/docs/learn/interoperability/xcm) - Explains how XCM is used in Astar and also how developers can use it to interact with the rest of the Polkadot network.
- [**Integrations**](/docs/build/integrations/) - Provides relevant information about the wallets, indexers, and oracles that are integrated with the network.
- [**Docs Integration Request**](https://github.com/AstarNetwork/astar-docs/blob/main/docs-integration-request.md) - Provides information about how to make a documentation integration request.

[cbridge]: https://cbridge.celer.network/#/transfer
38 changes: 0 additions & 38 deletions infrastructure_pull_request_template.md

This file was deleted.

0 comments on commit 0385652

Please sign in to comment.