Skip to content

Commit

Permalink
add contributing guide
Browse files Browse the repository at this point in the history
  • Loading branch information
arobsn committed Jul 9, 2024
1 parent e4c59a5 commit cd3afac
Show file tree
Hide file tree
Showing 6 changed files with 23 additions and 44 deletions.
16 changes: 16 additions & 0 deletions .github/contributing.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,16 @@
## Contributing

This site is built with [VitePress](https://github.com/vuejs/vitepress). Site content is written in Markdown format located in `docs`. For simple edits, you can directly edit the file on GitHub and generate a Pull Request.

For local development, Node.js `v18` or higher and [pnpm](https://pnpm.io/) `v9` or higher are required:

```bash
pnpm i
pnpm run dev
```

## Working on the content

- See VitePress docs on supported [Markdown Extensions](https://vitepress.dev/guide/markdown).

- We adopt the same [Writing Guide](https://github.com/vuejs/docs/blob/main/.github/contributing/writing-guide.md) as Vue.js for rules and recommendations on writing and maintaining documentation content.
2 changes: 1 addition & 1 deletion .github/workflows/deploy.yml
Original file line number Diff line number Diff line change
Expand Up @@ -22,7 +22,7 @@ jobs:
- run: pnpm install --frozen-lockfile

- name: Build
run: pnpm run docs:build
run: pnpm run build

- name: Deploy
uses: peaceiris/actions-gh-pages@v3
Expand Down
12 changes: 3 additions & 9 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,15 +1,9 @@
# 📄 Documentation for Fleet SDK
# 📄 Fleet SDK docs

[Fleet SDK](https://github.com/fleet-sdk/fleet) is an easy-to-use, modular, and extensible off-chain SDK (Software Development Kit)for the [Ergo Platform](https://ergoplatform.org/en/), written entirely in TypeScript.

**Fleet SDK** is currently in alpha status. It is already suitable for out-of-the-box use, but the API may still change between minor releases.

This repository is for the [Fleet SDK Documentation](https://fleet-sdk.github.io/docs/) website.
[Fleet SDK](https://github.com/fleet-sdk/fleet) is an easy-to-use, modular, and extensible off-chain SDK (Software Development Kit) for the [Ergo Platform](https://ergoplatform.org/en/), written entirely in TypeScript.

## Contributing

This site is built with [VitePress](https://github.com/vuejs/vitepress). Site content is written in Markdown format. For simple edits, you can directly edit the file on GitHub and generate a Pull Request. If you would like to use an IDE, [Visual Studio](https://visualstudio.microsoft.com/) works well with documentation using VitePress.

## Working on the content

- See VitePress docs on supported [Markdown Extensions](https://vitepress.vuejs.org/guide/markdown.html) and the ability to [use Vue syntax inside markdown](https://vitepress.vuejs.org/guide/using-vue.html).
Please refer to the [Contributing guide](/.github/contributing.md) for more details.
26 changes: 0 additions & 26 deletions docs/.vitepress/config.ts
Original file line number Diff line number Diff line change
Expand Up @@ -58,31 +58,5 @@ function sidebarGuide() {
{ text: "Token burning", link: "/token-burning" }
]
}
// {
// text: "Advanced Usage",
// collapsible: false,
// items: [
// { text: "Tweaking the Input Selector", link: "" },
// { text: "Working with Constants", link: "" }
// ]
// },
// {
// text: "Built-in Plugins",
// collapsible: false,
// items: [
// { text: "Babel Fees", link: "" },
// { text: "Sigma USD", link: "" },
// { text: "SigmaFi", link: "" }
// ]
// },
// {
// text: "Plugin Authoring",
// collapsible: false,
// items: [
// { text: "Getting Started", link: "" },
// { text: "API specifications", link: "" },
// { text: "Examples", link: "" }
// ]
// }
];
}
4 changes: 0 additions & 4 deletions docs/getting-started.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,10 +2,6 @@

Fleet SDK is an easy-to-use, modular, and extensible off-chain SDK (Software Development Kit) for the [Ergo Platform](https://ergoplatform.org/en/), written entirely in TypeScript.

::: warning
**Fleet SDK** is currently in alpha status. It is already suitable for out-of-the-box use, but the API may still change between minor releases.
:::

## Step. 1: Install

Add Fleet SDK as a dependency for the project.
Expand Down
7 changes: 3 additions & 4 deletions package.json
Original file line number Diff line number Diff line change
Expand Up @@ -2,11 +2,10 @@
"name": "docs",
"version": "1.0.0",
"description": "",
"packageManager": "[email protected]",
"scripts": {
"docs:dev": "vitepress dev docs",
"docs:build": "vitepress build docs",
"docs:preview": "vitepress preview docs"
"dev": "vitepress dev docs",
"build": "vitepress build docs",
"preview": "vitepress preview docs"
},
"keywords": [],
"author": "",
Expand Down

0 comments on commit cd3afac

Please sign in to comment.