From 11da317f55745aae7692004f4dc3365fd22dde63 Mon Sep 17 00:00:00 2001 From: Mostafa Date: Thu, 18 Jun 2026 19:51:12 +0800 Subject: [PATCH] chore: remove preface heading from pages The "## Preface" heading served as a meta-label rather than descriptive content. Removing it allows introductory text to flow naturally after the frontmatter, following standard documentation conventions. Also fix MD029 linting issue in grpc-basic-auth.md (code block indentation within ordered list). --- .mdlrc.rb | 2 +- content/get-started/become-a-validator.md | 3 ++- content/get-started/configuration.md | 2 -- content/get-started/pactus-daemon.md | 2 -- content/get-started/pactus-docker.md | 2 -- content/get-started/pactus-gui.md | 2 -- content/tutorials/grpc-basic-auth.md | 16 +++++++--------- content/tutorials/grpc-sign-transactions.md | 2 -- content/tutorials/integration-guide.md | 2 -- content/tutorials/linux-systemd.md | 2 -- content/tutorials/pactus-metrics.md | 2 -- content/tutorials/pactus-testnet.md | 2 -- content/tutorials/pactus-wallet.md | 2 -- content/tutorials/pruned-nodes.md | 2 -- content/tutorials/reduce-network.md | 2 -- content/tutorials/secure-connections.md | 2 -- content/tutorials/send-transaction-gui.md | 2 -- content/tutorials/software-verification.md | 2 -- content/tutorials/zero-fee-transactions.md | 2 -- 19 files changed, 10 insertions(+), 43 deletions(-) diff --git a/.mdlrc.rb b/.mdlrc.rb index 254fc10..e87148e 100644 --- a/.mdlrc.rb +++ b/.mdlrc.rb @@ -24,5 +24,5 @@ # First line in file should be a top level header exclude_rule 'MD041' +# Allow Multiple headers with the same content exclude_rule 'MD024' -exclude_rule 'MD029' \ No newline at end of file diff --git a/content/get-started/become-a-validator.md b/content/get-started/become-a-validator.md index 1dfa3e5..b652a20 100644 --- a/content/get-started/become-a-validator.md +++ b/content/get-started/become-a-validator.md @@ -13,7 +13,8 @@ they are self-elected through a randomization algorithm based on their stake and ## What Roles do Validators Play? -Validators can run Pactus Core software on their personal computers or remote servers to process transactions, create blocks, +Validators can run Pactus Core software on their personal computers or +remote servers to process transactions, create blocks, and uphold network security and decentralization. By staking their own coins, validators contribute to the network's security and are rewarded for their efforts. diff --git a/content/get-started/configuration.md b/content/get-started/configuration.md index 8f232c1..c39ff24 100644 --- a/content/get-started/configuration.md +++ b/content/get-started/configuration.md @@ -3,8 +3,6 @@ title: Pactus Node Configuration weight: 6 --- -## Preface - The Pactus node can be configured using a [TOML](https://toml.io/en/) file, which is a simple text format for configuration. This file is automatically created when the node initializes. diff --git a/content/get-started/pactus-daemon.md b/content/get-started/pactus-daemon.md index e309006..f73e61a 100644 --- a/content/get-started/pactus-daemon.md +++ b/content/get-started/pactus-daemon.md @@ -3,8 +3,6 @@ title: Run Pactus in Command Line Mode weight: 3 --- -## Preface - Pactus can be run in different modes, including the command-line interface (CLI) and the graphical user interface (GUI). This tutorial will guide you through the steps to run Pactus in CLI mode, suitable for advanced users. diff --git a/content/get-started/pactus-docker.md b/content/get-started/pactus-docker.md index 41ab185..11a8a75 100644 --- a/content/get-started/pactus-docker.md +++ b/content/get-started/pactus-docker.md @@ -3,8 +3,6 @@ title: Run Pactus using Docker weight: 4 --- -## Preface - Docker is a tool that simplifies the process of creating, deploying, and running applications using containers. With containers, developers can bundle all the necessary parts of an application, including libraries and dependencies, and deploy them as a single package. diff --git a/content/get-started/pactus-gui.md b/content/get-started/pactus-gui.md index 3f50b1d..ca960ea 100644 --- a/content/get-started/pactus-gui.md +++ b/content/get-started/pactus-gui.md @@ -3,8 +3,6 @@ title: Run Pactus in Graphic Mode weight: 2 --- -## Preface - Pactus can be run in different modes, including the command-line interface (CLI) and the graphical user interface (GUI). This tutorial will guide you through the steps to run Pactus in GUI mode, suitable for beginner to advanced users. diff --git a/content/tutorials/grpc-basic-auth.md b/content/tutorials/grpc-basic-auth.md index a730daf..84c992c 100644 --- a/content/tutorials/grpc-basic-auth.md +++ b/content/tutorials/grpc-basic-auth.md @@ -3,8 +3,6 @@ title: Secure gRPC Using Basic Authentication weight: 6 --- -## Preface - The Pactus Blockchain offers a gRPC interface, enabling users to interact with the blockchain and its native wallet. To enhance the security of gRPC APIs, we have implemented a Basic Authentication mechanism based on [bcrypt](https://en.wikipedia.org/wiki/Bcrypt) password hashing. @@ -77,12 +75,12 @@ To enable Basic Authentication in your Pactus Blockchain configuration, follow t 1. Open the [configuration](https://docs.pactus.org/get-started/configuration/) file in your Pactus directory. 2. Insert the generated user with the hashed password into the `basic_auth` field in the `grpc` section: -```toml -[grpc] -enable = true -enable_wallet = false -listen = "127.0.0.1:50051" -basic_auth = "user:$2a$10$nl6VKEzSENIK5dmzoADgKeTFtCusQxeVCZiXkRzzbyfG.bLpHtrda" -``` + ```toml + [grpc] + enable = true + enable_wallet = false + listen = "127.0.0.1:50051" + basic_auth = "user:$2a$10$nl6VKEzSENIK5dmzoADgKeTFtCusQxeVCZiXkRzzbyfG.bLpHtrda" + ``` 3. Restart or run the node to apply this configuration. diff --git a/content/tutorials/grpc-sign-transactions.md b/content/tutorials/grpc-sign-transactions.md index 164a449..fbe2ee5 100644 --- a/content/tutorials/grpc-sign-transactions.md +++ b/content/tutorials/grpc-sign-transactions.md @@ -3,8 +3,6 @@ title: Sign Transactions Using gRPC weight: 5 --- -## Preface - The Pactus Blockchain provides a gRPC interface that allows users to interact with the blockchain and native wallet. This is ideal for merchants and users who want to create, sign, and broadcast transactions using their local node. This tutorial will guide you step-by-step on how to use gRPC to sign transactions. diff --git a/content/tutorials/integration-guide.md b/content/tutorials/integration-guide.md index 8191f7e..430dda0 100644 --- a/content/tutorials/integration-guide.md +++ b/content/tutorials/integration-guide.md @@ -3,8 +3,6 @@ title: Pactus Integration Guide weight: 14 --- -## Preface - This guide is intended for developers and infrastructure teams who want to connect their applications directly to the Pactus network, including wallets, exchanges, analytics platforms, staking services, and custom backend systems. diff --git a/content/tutorials/linux-systemd.md b/content/tutorials/linux-systemd.md index d69a5c6..3624e6a 100644 --- a/content/tutorials/linux-systemd.md +++ b/content/tutorials/linux-systemd.md @@ -3,8 +3,6 @@ title: Run Pactus as a Systemd Service weight: 11 --- -## Preface - [Systemd](https://en.wikipedia.org/wiki/Systemd) is a system and service manager for Linux that helps manage how programs start up, run, and shut down. It also handles system processes, logging, and basic service monitoring. diff --git a/content/tutorials/pactus-metrics.md b/content/tutorials/pactus-metrics.md index f75e9f6..4979e5c 100644 --- a/content/tutorials/pactus-metrics.md +++ b/content/tutorials/pactus-metrics.md @@ -3,8 +3,6 @@ title: Run Pactus Metrics weight: 10 --- -## Preface - Pactus can be run with metrics, providing you with the ability to monitor your node. This tutorial will guide you through the steps to run Pactus with metrics, suitable for advanced users. diff --git a/content/tutorials/pactus-testnet.md b/content/tutorials/pactus-testnet.md index 1fdebf3..f05fa29 100644 --- a/content/tutorials/pactus-testnet.md +++ b/content/tutorials/pactus-testnet.md @@ -3,8 +3,6 @@ title: Join Pactus Testnet weight: 15 --- -## Preface - The Pactus testnet is a public testing environment that replicates the functionality of the mainnet but uses test coins with no real-world value. Running a node on the testnet allows you to experiment safely, test applications, diff --git a/content/tutorials/pactus-wallet.md b/content/tutorials/pactus-wallet.md index 44c3202..c2d3c90 100644 --- a/content/tutorials/pactus-wallet.md +++ b/content/tutorials/pactus-wallet.md @@ -3,8 +3,6 @@ title: Use Pactus Wallet weight: 2 --- -## Preface - The Pactus Blockchain provides a wallet application that allows users to interact with the Pactus blockchain without the need to run a node. This is ideal for users who do not wish to operate a node but still want to create a personal wallet to manage their funds. diff --git a/content/tutorials/pruned-nodes.md b/content/tutorials/pruned-nodes.md index 85ed50c..85ca9be 100644 --- a/content/tutorials/pruned-nodes.md +++ b/content/tutorials/pruned-nodes.md @@ -3,8 +3,6 @@ title: Running a Pruned Node weight: 4 --- -## Preface - The Pactus Blockchain supports pruned nodes to help users manage storage efficiently by retaining only the most recent and relevant data. This tutorial will guide you step-by-step on how to prune your node, whether using the command line or the graphical interface. diff --git a/content/tutorials/reduce-network.md b/content/tutorials/reduce-network.md index ca6f73d..da13e82 100644 --- a/content/tutorials/reduce-network.md +++ b/content/tutorials/reduce-network.md @@ -3,8 +3,6 @@ title: Reduce Network Usage weight: 9 --- -## Preface - Pactus is designed for low traffic usage. However, some users still face bandwidth limitations imposed by their Internet Service Providers (ISPs). This guide will explore effective ways to reduce network usage for a Pactus node. diff --git a/content/tutorials/secure-connections.md b/content/tutorials/secure-connections.md index 589f105..d52eedf 100644 --- a/content/tutorials/secure-connections.md +++ b/content/tutorials/secure-connections.md @@ -3,8 +3,6 @@ title: Secure Connections weight: 7 --- -## Preface - As the Pactus blockchain grows, the need for individuals and merchants to communicate and interact with Pactus nodes is increasing. Pactus provides several communication protocols, diff --git a/content/tutorials/send-transaction-gui.md b/content/tutorials/send-transaction-gui.md index 62c8136..60a4368 100644 --- a/content/tutorials/send-transaction-gui.md +++ b/content/tutorials/send-transaction-gui.md @@ -3,8 +3,6 @@ title: Send Transactions in Graphic Mode weight: 1 --- -## Preface - The Pactus Blockchain offers a Graphical User Interface (GUI) that comes with a built-in wallet to create, sign and broadcast transactions. This tutorial aims to guide you step-by-step on how to use the GUI application to send transactions to the Pactus blockchain. diff --git a/content/tutorials/software-verification.md b/content/tutorials/software-verification.md index 3644dac..698d685 100644 --- a/content/tutorials/software-verification.md +++ b/content/tutorials/software-verification.md @@ -3,8 +3,6 @@ title: Verify Pactus Software Is Safe weight: 12 --- -## Preface - When downloading Pactus software, it's important to verify that the binaries are authentic and haven't been tampered with. By verifying the signatures of the files, you ensure that the software you're installing is secure. diff --git a/content/tutorials/zero-fee-transactions.md b/content/tutorials/zero-fee-transactions.md index 356d81e..e6bbb21 100644 --- a/content/tutorials/zero-fee-transactions.md +++ b/content/tutorials/zero-fee-transactions.md @@ -3,8 +3,6 @@ title: Send Zero-Fee Transactions weight: 13 --- -## Preface - Pactus supports zero-fee transactions starting from [Version 1.6.0 (Mumbai)](https://pactus.org/2024/11/14/pactus-1.6.0-mumbai-released/). However, for security reasons, there are restrictions on zero-fee transactions: