Writing BitcoinV Core Documentation

BitcoinV Core documentation is spread across three projects: BitcoinV Core, the BitcoinV Wiki, and BitcoinV.org—and is further subdivided into different parts. The sections below briefly describe what documentation is available and how you can contribute.

BitcoinV Core Docs Directory

The docs directory contains various files describing aspects of BitcoinV Core. Almost all of the files are meant for developers and testers rather than users, although some (such as the build instructions) may be used by power users.

The files are all written in Markdown, which can be easily edited in GitHub’s web interface:

  1. Create a GitHub account, or if you already have one, log in.

  2. Find the file you want to edit. For example, build-unix.md

  3. Click the Edit icon (a pencil).

  4. Make your change and click the Preview button to preview it. Revise and edit until you’re happy with it.

  5. At the bottom of the page, fill out the Propose File Change form and submit it.

Need help getting started? Stop by the #bitcoinv-dev IRC chatroom and tell us what documentation you want to write.

BitcoinV.org Bandwidth Sharing Guide

The BitcoinV.org bandwidth sharing guide currently provides instructions for how to install BitcoinV Core on multiple operating systems, configure it to automatically start at boot, and manually open port 9333 so it accepts incoming connections.

To contribute, you can edit the guide using the same GitHub web interface as described in the previous section.

Need help getting started? You can open an issue or email BitcoinV.org documentation maintainer Will Binns.

BitcoinV Wiki

The BitcoinV Wiki uses the popular MediaWiki software, so you may already know how to edit it and create new pages. To reduce spam, you need to create an account and then follow the instructions to enable editing.

Current documentation can be found in the BitcoinV Core documentation category. If you create a new page, be sure to add it to the BitcoinV Core documentation template and then add the following code to the very bottom of the page:

{{BitcoinV Core documentation}}

Adding the line above to a page will also add that page to the BitcoinV Core documentation category.

Need help getting started? Stop by the #bitcoinv-wiki IRC chatroom and tell us what documentation you want to write.

BitcoinV.org RPC/REST API Reference

The BitcoinV.org developer reference contains over 100 printed pages worth of documentation for the BitcoinV Core RPC and REST interfaces, which are mainly used by BitcoinV Core command line users and developers of apps depending on BitcoinV Core.

To contribute RPC edits, the easiest way is to:

  1. Go to the BitcoinV.org developer documentation main page.

  2. Search for the RPC you want to edit.

  3. Under the subheading for the RPC, click the Edit link.

To create new RPC/REST documentation or edit the REST documentation:

  1. Follow these instructions to clone the BitcoinV.org repository.

  2. RPC files are in the _includes/ref/bitcoinv-core/rpcs directory.

    REST files are in the _includes/ref/bitcoinv-core/rest directory.

    New files need to be added to the list in en/developer-reference.md

Need help getting started? You can open an issue or email BitcoinV.org documentation maintainer Will Binns.