From 7181dc943d431223019eb40985c23dd1bb414c58 Mon Sep 17 00:00:00 2001 From: Steve Loeppky Date: Fri, 7 Apr 2023 09:23:56 -0700 Subject: [PATCH] docs: readme tidyup (status, organization, etc.) (#83) Doing some items I saw while looking fresh at https://github.com/ipfs/helia/issues/35 This includes: 1. Moving contribution section up higher since this is important. 2. Updating the status section. 3. Combining about "code structure" both internally and as it relates to other projects. 4. Added a "notable users" section as a call that we'd like to hear from users and fill this in. 5. (bonus - feel free to reject) added some emojis for more color on the page. --- README.md | 86 ++++++++++++++++++++++++++++--------------------------- 1 file changed, 44 insertions(+), 42 deletions(-) diff --git a/README.md b/README.md index 61d806b8b..d265f0731 100644 --- a/README.md +++ b/README.md @@ -11,84 +11,86 @@ [![codecov](https://img.shields.io/codecov/c/github/ipfs/helia.svg?style=flat-square)](https://codecov.io/gh/ipfs/helia) [![CI](https://img.shields.io/github/actions/workflow/status/ipfs/helia/main.yml?branch=main\&style=flat-square)](https://github.com/ipfs/helia/actions/workflows/main.yml?query=branch%3Amain) -> An implementation of IPFS in JavaScript - ## Table of contents -- [Purpose and goals](#purpose-and-goals) -- [Getting Started](#getting-started) -- [Project status](#project-status) -- [Roadmap](#roadmap) -- [Get involved](#get-involved) -- [API Docs](#api-docs) -- [Structure](#structure) -- [Name](#name) -- [License](#license) -- [Contribute](#contribute) +- [🥅 Purpose and goals](#-purpose-and-goals) +- [🏃‍♀️ Getting Started](#️-getting-started) +- [📒 API Docs](#-api-docs) +- [🏭 Code Structure](#-code-structure) +- [📣 Project status](#-project-status) +- [🛣️ Roadmap](#️-roadmap) +- [👫 Get involved](#-get-involved) + - [🤲 Contribute](#-contribute) +- [🛍️ Notable Consumers/Users](#️-notable-consumersusers) +- [🌞 Name](#-name) +- [🪪 License](#-license) -## Purpose and goals +## 🥅 Purpose and goals A lean, modular, and modern implementation of IPFS for the prolific JS and browser environments. See the [Manifesto](./MANIFESTO.md) and the [State of IPFS in JS blog post from October 2022](https://blog.ipfs.tech/state-of-ipfs-in-js/) for more info. -## Getting Started +## 🏃‍♀️ Getting Started Check out the [Helia examples repo](https://github.com/ipfs-examples/helia-examples#examples), which covers a wide variety of use cases. If you feel something has been missed, follow the [contribution guide](https://github.com/ipfs-examples/helia-examples#contributing) and create a PR to the examples repo. -Helia embraces the modular approach and encourages you to bring your own implementations of interfacing libraries to suit your needs. Helia also ships supplemental libraries and tooling compatible with Helia: +## 📒 API Docs + +- https://ipfs.github.io/helia + +## 🏭 Code Structure +Helia embraces a modular approach and encourages users to bring their own implementations of interfacing libraries to suit their needs. Helia also ships supplemental libraries and tools including: - [`@helia/UnixFS`](https://github.com/ipfs/helia-unixfs) - [`@helia/ipns`](https://github.com/ipfs/helia-ipns) -These libraries are by no means the "one true implementation", instead these are meant to configurable as per your needs. - -## Project status +These libraries are by no means the "one true implementation", but instead instead provide optionality depending on one's needs. -As of early 2023, this project is pre-alpha and is currently in development. These initial building blocks are in development now; have a look at this repo's PR(s). An initial v1 release is planned for [late Q1 2023](/ROADMAP.md#late-q1-march). +This repo itself is made up of these packages: +- [`/packages/interface`](./packages/interface) The Helia API +- [`/packages/helia`](./packages/helia) An implementation of the Helia API +- [`/packages/interop`](./packages/interop) Interop tests for Helia -## Roadmap +## 📣 Project status +Helia v1 shipped in 202303 (see [releases](https://github.com/ipfs/helia/releases)), and development keeps on trucking as we work on initiatives in the [roadmap](#roadmap) and make performance improvements and bug fixes along the way. +## 🛣️ Roadmap Please find and comment on [the Roadmap here](https://github.com/ipfs/helia/issues/5). -## Get involved - +## 👫 Get involved * Watch our Helia Demo Day presentations [here](https://www.youtube.com/playlist?list=PLuhRWgmPaHtQAnt8INOe5-kV9TLVaUJ9v) * We are sharing about the progress at periodic [Helia Demos](https://lu.ma/helia). This is a good place to find out the latest and learn of ways to get involved. We'd love to see you there! * Pick up one of the [issues](https://github.com/ipfs/helia/issues). * Come chat in Filecoin Slack #ip-js. (Yes, we should bridge this to other chat enviornments. Please comment [here](https://github.com/ipfs/helia/issues/33) if you'd like this.) -## API Docs - -- +### 🤲 Contribute -## Structure +Contributions welcome! Please check out [the issues](https://github.com/ipfs/helia/issues). -- [`/packages/helia`](./packages/helia) An implementation of IPFS in JavaScript -- [`/packages/interface`](./packages/interface) The Helia API -- [`/packages/interop`](./packages/interop) Interop tests for Helia +Also see our [contributing document](https://github.com/ipfs/community/blob/master/CONTRIBUTING_JS.md) for more information on how we work, and about contributing in general. -## Name +Please be aware that all interactions related to this repo are subject to the IPFS [Code of Conduct](https://github.com/ipfs/community/blob/master/code-of-conduct.md). -Helia (*HEE-lee-ah*) is the Latin spelling of Ἡλιη -- in Greek mythology, one of the [Heliades](https://www.wikidata.org/wiki/Q12656412): the daughters of the sun god Helios. When their brother Phaethon died trying to drive the sun chariot across the sky, their tears of mourning fell to earth as amber, which is yellow (sort of), and so is JavaScript. They were then turned into [poplar](https://en.wiktionary.org/wiki/poplar) trees and, well, JavaScript is quite popular. +Unless you explicitly state otherwise, any contribution intentionally submitted for inclusion in the work by you, as defined in the Apache-2.0 license, shall be dual licensed as above, without any additional terms or conditions. -In Oct–Dec 2022, [PL EngRes IP Stewards](https://pl-strflt.notion.site/IP-Stewards-9b65f88602474557b5d6f644194e941f) [sought community input](https://github.com/ipfs/pomegranate/issues/3) for the name of this project. After considering 20 suggestions and holding a couple of polls, the name **Helia** was chosen. Here's [why "ipfs" is not in the name](https://github.com/ipfs/ipfs/issues/470). +[![](https://cdn.rawgit.com/jbenet/contribute-ipfs-gif/master/img/contribute.gif)](https://github.com/ipfs/community/blob/master/CONTRIBUTING.md) -## License +## 🛍️ Notable Consumers/Users -Licensed under either of +** -- Apache 2.0, ([LICENSE-APACHE](LICENSE-APACHE) / ) -- MIT ([LICENSE-MIT](LICENSE-MIT) / ) +Helia is in its early days. If you're using Helia in production or have a novel usecase, we'd love to hear. Please open an issue so we can learn more! -## Contribute +## 🌞 Name -Contributions welcome! Please check out [the issues](https://github.com/ipfs/helia/issues). +Helia (*HEE-lee-ah*) is the Latin spelling of Ἡλιη -- in Greek mythology, one of the [Heliades](https://www.wikidata.org/wiki/Q12656412): the daughters of the sun god Helios. When their brother Phaethon died trying to drive the sun chariot across the sky, their tears of mourning fell to earth as amber, which is yellow (sort of), and so is JavaScript. They were then turned into [poplar](https://en.wiktionary.org/wiki/poplar) trees and, well, JavaScript is quite popular. -Also see our [contributing document](https://github.com/ipfs/community/blob/master/CONTRIBUTING_JS.md) for more information on how we work, and about contributing in general. +In Oct–Dec 2022, [PL EngRes IP Stewards](https://pl-strflt.notion.site/IP-Stewards-9b65f88602474557b5d6f644194e941f) [sought community input](https://github.com/ipfs/pomegranate/issues/3) for the name of this project. After considering 20 suggestions and holding a couple of polls, the name **Helia** was chosen. Here's [why "ipfs" is not in the name](https://github.com/ipfs/ipfs/issues/470). -Please be aware that all interactions related to this repo are subject to the IPFS [Code of Conduct](https://github.com/ipfs/community/blob/master/code-of-conduct.md). +## 🪪 License -Unless you explicitly state otherwise, any contribution intentionally submitted for inclusion in the work by you, as defined in the Apache-2.0 license, shall be dual licensed as above, without any additional terms or conditions. +Licensed under either of -[![](https://cdn.rawgit.com/jbenet/contribute-ipfs-gif/master/img/contribute.gif)](https://github.com/ipfs/community/blob/master/CONTRIBUTING.md) +- Apache 2.0, ([LICENSE-APACHE](LICENSE-APACHE) / ) +- MIT ([LICENSE-MIT](LICENSE-MIT) / )