mirror of
https://github.com/fluencelabs/tendermint
synced 2025-04-25 14:52:17 +00:00
rpc: Improve slate for Jenkins (#2070)
This commit is contained in:
parent
24b94d7aa4
commit
66fe5b7bae
1
.gitignore
vendored
1
.gitignore
vendored
@ -17,6 +17,7 @@ docs/_build
|
|||||||
*.log
|
*.log
|
||||||
abci-cli
|
abci-cli
|
||||||
docs/node_modules/
|
docs/node_modules/
|
||||||
|
index.html.md
|
||||||
|
|
||||||
scripts/wal2json/wal2json
|
scripts/wal2json/wal2json
|
||||||
scripts/cutWALUntil/cutWALUntil
|
scripts/cutWALUntil/cutWALUntil
|
||||||
|
8
Makefile
8
Makefile
@ -246,6 +246,12 @@ metalinter_all:
|
|||||||
@echo "--> Running linter (all)"
|
@echo "--> Running linter (all)"
|
||||||
gometalinter.v2 --vendor --deadline=600s --enable-all --disable=lll ./...
|
gometalinter.v2 --vendor --deadline=600s --enable-all --disable=lll ./...
|
||||||
|
|
||||||
|
DESTINATION = ./index.html.md
|
||||||
|
|
||||||
|
rpc-docs:
|
||||||
|
cat rpc/core/slate_header.txt > $(DESTINATION)
|
||||||
|
godoc2md -template rpc/core/doc_template.txt github.com/tendermint/tendermint/rpc/core | grep -v -e "pipe.go" -e "routes.go" -e "dev.go" | sed 's,/src/target,https://github.com/tendermint/tendermint/tree/master/rpc/core,' >> $(DESTINATION)
|
||||||
|
|
||||||
check_dep:
|
check_dep:
|
||||||
dep status >> /dev/null
|
dep status >> /dev/null
|
||||||
!(grep -n branch Gopkg.toml)
|
!(grep -n branch Gopkg.toml)
|
||||||
@ -305,4 +311,4 @@ build-slate:
|
|||||||
# To avoid unintended conflicts with file names, always add to .PHONY
|
# To avoid unintended conflicts with file names, always add to .PHONY
|
||||||
# unless there is a reason not to.
|
# unless there is a reason not to.
|
||||||
# https://www.gnu.org/software/make/manual/html_node/Phony-Targets.html
|
# https://www.gnu.org/software/make/manual/html_node/Phony-Targets.html
|
||||||
.PHONY: check build build_race build_abci dist install install_abci check_dep check_tools get_tools update_tools get_vendor_deps draw_deps get_protoc protoc_abci protoc_libs gen_certs clean_certs grpc_dbserver test_cover test_apps test_persistence test_p2p test test_race test_integrations test_release test100 vagrant_test fmt build-linux localnet-start localnet-stop build-docker build-docker-localnode sentry-start sentry-config sentry-stop build-slate protoc_grpc protoc_all
|
.PHONY: check build build_race build_abci dist install install_abci check_dep check_tools get_tools update_tools get_vendor_deps draw_deps get_protoc protoc_abci protoc_libs gen_certs clean_certs grpc_dbserver test_cover test_apps test_persistence test_p2p test test_race test_integrations test_release test100 vagrant_test fmt rpc-docs build-linux localnet-start localnet-stop build-docker build-docker-localnode sentry-start sentry-config sentry-stop build-slate protoc_grpc protoc_all
|
||||||
|
@ -1,18 +1,15 @@
|
|||||||
# Tendermint RPC
|
# Tendermint RPC
|
||||||
|
|
||||||
## Generate markdown for [Slate](https://github.com/tendermint/slate)
|
We are using [Slate](https://github.com/lord/slate) to power our RPC
|
||||||
|
|
||||||
We are using [Slate](https://github.com/tendermint/slate) to power our RPC
|
|
||||||
documentation. For generating markdown use:
|
documentation. For generating markdown use:
|
||||||
|
|
||||||
```shell
|
```shell
|
||||||
go get github.com/davecheney/godoc2md
|
go get github.com/davecheney/godoc2md
|
||||||
|
|
||||||
godoc2md -template rpc/core/doc_template.txt github.com/tendermint/tendermint/rpc/core | grep -v -e "pipe.go" -e "routes.go" -e "dev.go" | sed 's$/src/target$https://github.com/tendermint/tendermint/tree/master/rpc/core$'
|
# from root of this repo
|
||||||
|
make rpc-docs
|
||||||
```
|
```
|
||||||
|
|
||||||
For more information see the [CI script for building the Slate docs](/scripts/slate.sh)
|
|
||||||
|
|
||||||
## Pagination
|
## Pagination
|
||||||
|
|
||||||
Requests that return multiple items will be paginated to 30 items by default.
|
Requests that return multiple items will be paginated to 30 items by default.
|
||||||
|
13
rpc/core/slate_header.txt
Normal file
13
rpc/core/slate_header.txt
Normal file
@ -0,0 +1,13 @@
|
|||||||
|
---
|
||||||
|
title: RPC Reference
|
||||||
|
|
||||||
|
language_tabs: # must be one of https://git.io/vQNgJ
|
||||||
|
- shell
|
||||||
|
- go
|
||||||
|
|
||||||
|
toc_footers:
|
||||||
|
- <a href='https://tendermint.com/'>Tendermint</a>
|
||||||
|
- <a href='https://github.com/lord/slate'>Documentation Powered by Slate</a>
|
||||||
|
|
||||||
|
search: true
|
||||||
|
---
|
Loading…
x
Reference in New Issue
Block a user