Remove old book location (#7621)
This commit is contained in:
19
RELEASE.md
19
RELEASE.md
@ -140,25 +140,6 @@ TODO: Documentation update procedure is WIP as we move to gitbook
|
|||||||
|
|
||||||
Document the new recommended version by updating `book/src/running-archiver.md` and `book/src/validator-testnet.md` on the release (beta) branch to point at the `solana-install` for the upcoming release version.
|
Document the new recommended version by updating `book/src/running-archiver.md` and `book/src/validator-testnet.md` on the release (beta) branch to point at the `solana-install` for the upcoming release version.
|
||||||
|
|
||||||
#### Publish updated Book
|
|
||||||
We maintain three copies of the "book" as official documentation:
|
|
||||||
|
|
||||||
1) "Book" is the documentation for the latest official release. This should get manually updated whenever a new release is made. It is published here:
|
|
||||||
https://solana-labs.github.io/book/
|
|
||||||
|
|
||||||
2) "Book-edge" tracks the tip of the master branch and updates automatically.
|
|
||||||
https://solana-labs.github.io/book-edge/
|
|
||||||
|
|
||||||
3) "Book-beta" tracks the tip of the beta branch and updates automatically.
|
|
||||||
https://solana-labs.github.io/book-beta/
|
|
||||||
|
|
||||||
To manually trigger an update of the "Book", create a new job of the manual-update-book pipeline.
|
|
||||||
Set the tag of the latest release as the PUBLISH_BOOK_TAG environment variable.
|
|
||||||
```bash
|
|
||||||
PUBLISH_BOOK_TAG=v0.16.6
|
|
||||||
```
|
|
||||||
https://buildkite.com/solana-labs/manual-update-book
|
|
||||||
|
|
||||||
### Update software on testnet.solana.com
|
### Update software on testnet.solana.com
|
||||||
|
|
||||||
The testnet running on testnet.solana.com is set to use a fixed release tag
|
The testnet running on testnet.solana.com is set to use a fixed release tag
|
||||||
|
@ -8,7 +8,6 @@ me=$(basename "$0")
|
|||||||
echo --- update gitbook-cage
|
echo --- update gitbook-cage
|
||||||
if [[ -n $CI_BRANCH ]]; then
|
if [[ -n $CI_BRANCH ]]; then
|
||||||
(
|
(
|
||||||
|
|
||||||
set -x
|
set -x
|
||||||
(
|
(
|
||||||
. ci/rust-version.sh stable
|
. ci/rust-version.sh stable
|
||||||
@ -25,74 +24,8 @@ if [[ -n $CI_BRANCH ]]; then
|
|||||||
git reset --hard HEAD~
|
git reset --hard HEAD~
|
||||||
fi
|
fi
|
||||||
)
|
)
|
||||||
fi
|
|
||||||
|
|
||||||
|
|
||||||
source ci/rust-version.sh stable
|
|
||||||
eval "$(ci/channel-info.sh)"
|
|
||||||
|
|
||||||
if [[ -n $PUBLISH_BOOK_TAG ]]; then
|
|
||||||
CURRENT_TAG="$(git describe --tags)"
|
|
||||||
COMMIT_TO_PUBLISH="$(git rev-list -n 1 "${PUBLISH_BOOK_TAG}")"
|
|
||||||
|
|
||||||
# book is manually published at a specified release tag
|
|
||||||
if [[ $PUBLISH_BOOK_TAG != "$CURRENT_TAG" ]]; then
|
|
||||||
(
|
|
||||||
cat <<EOF
|
|
||||||
steps:
|
|
||||||
- trigger: "$BUILDKITE_PIPELINE_SLUG"
|
|
||||||
async: true
|
|
||||||
build:
|
|
||||||
message: "$BUILDKITE_MESSAGE"
|
|
||||||
commit: "$COMMIT_TO_PUBLISH"
|
|
||||||
env:
|
|
||||||
PUBLISH_BOOK_TAG: "$PUBLISH_BOOK_TAG"
|
|
||||||
EOF
|
|
||||||
) | buildkite-agent pipeline upload
|
|
||||||
exit 0
|
|
||||||
fi
|
|
||||||
repo=git@github.com:solana-labs/book.git
|
|
||||||
BOOK="book"
|
|
||||||
else
|
else
|
||||||
# book-edge and book-beta are published automatically on the tip of the branch
|
echo CI_BRANCH not set
|
||||||
case $CHANNEL in
|
|
||||||
edge)
|
|
||||||
repo=git@github.com:solana-labs/book-edge.git
|
|
||||||
;;
|
|
||||||
beta)
|
|
||||||
repo=git@github.com:solana-labs/book-beta.git
|
|
||||||
;;
|
|
||||||
*)
|
|
||||||
echo "--- publish skipped"
|
|
||||||
exit 0
|
|
||||||
;;
|
|
||||||
esac
|
|
||||||
BOOK=$CHANNEL
|
|
||||||
fi
|
fi
|
||||||
|
|
||||||
ci/docker-run.sh "$rust_stable_docker_image" bash -exc "book/build.sh"
|
|
||||||
|
|
||||||
echo --- create book repo
|
|
||||||
(
|
|
||||||
set -x
|
|
||||||
cd book/html/
|
|
||||||
git init .
|
|
||||||
git add ./* ./.nojekyll
|
|
||||||
git config user.email maintainers@solana.com
|
|
||||||
git config user.name "$me"
|
|
||||||
git commit -m "${CI_COMMIT:-local}"
|
|
||||||
)
|
|
||||||
|
|
||||||
echo "--- publish $BOOK"
|
|
||||||
(
|
|
||||||
cd book/html/
|
|
||||||
git remote add origin $repo
|
|
||||||
git fetch origin master
|
|
||||||
if ! git diff HEAD origin/master --quiet; then
|
|
||||||
git push -f origin HEAD:master
|
|
||||||
else
|
|
||||||
echo "Content unchanged, publish skipped"
|
|
||||||
fi
|
|
||||||
)
|
|
||||||
|
|
||||||
exit 0
|
exit 0
|
||||||
|
Reference in New Issue
Block a user