Skip to content

filecoin-project/lotus-docs

Repository files navigation

Lotus docs

This repository contains the documentation, build scripts, and issue tracking for the Lotus project. If you'd just like to read the Lotus docs, head to lotus.filecoin.io.

Get involved

We would love ❤️ your help to improve existing items or make new ones even better!

Issues

If you find something wrong within this repository, please raise an issue here →.

If you are attempting to close an issue, great! Thanks for the help! Please leave a comment within the issue requesting to be assigned to that issue before submitting a pull request. This minimizes the chance of multiple different contributors duplicating work by submitting pull requests for the same issue. If you submit a pull request to an issue without first being assigned to it, that pull request may not be accepted.

Suggestions

Everyone has an opinion when it comes to docs, and that's a good thing! Having folks from different backgrounds add to a discussion empowers everyone within that discussion. So if you've got something to add or would like to bring up a topic for discussion about the Lotus Docs project, please do so! Just create an issue using the kind/discussion tag!.

Pull requests welcome

Feel free to submit pull requests with any changes you'd like to see! If you're simply changing a typo or editing out a styling bug, you can add ciskip to the title of your pull request to stop Filecorgi from running.

Project set up

If you want to build this site locally, run the following:

  1. Clone this repository:

    git clone https://github.com/filecoin-project/lotus-docs.git
  2. Move into the lotus-docs folder and install the NPM dependencies:

    cd lotus-docs
    npm install
  3. Boot up the application in developer mode:

    npm start
  4. Open localhost:1313 in your browser.

  5. Close the local server with CTRL + c.

  6. To restart the local server, run npm start from within the lotus-docs folder.

  7. Run npm run build to publish the site. The project will be built and saved to the public folder.

Publishing

This site is published publicly using fleek.xyz so it accessible via vanilla browser HTTPS and IPFS protocols:

"Fleek CI" is a configured GitHub app for this repo that does the publishing.
It is tied to the infra@filoz.org fleek.xyz account. (The credentials are stored in FilOz 1Password.)

lotus.filecoin.io DNS configuration is done with sead.ai, as they are the DNS managers of the filecoin.io domain.

License

Dual-licensed by Protocol Labs under Apache 2.0 and MIT terms, as explained in the Permissive License Stack: