Skip to content

Conversation

@longfeiWan9
Copy link
Collaborator

@longfeiWan9 longfeiWan9 commented Oct 20, 2025

Closes #322

This PR introduces a new "Introduction" section to the documentation with two key pages that provide a comprehensive overview of Filecoin Onchain Cloud (FOC) for new users and developers.

Changes Made

📄 New Pages Added

  • intro/about.md - Comprehensive overview of what Filecoin Onchain Cloud is, its architecture, and core components
  • intro/why.md - Detailed explanation of why developers should choose FOC over traditional cloud solutions

🏗️ Re-structure the content for coming content, includes:

  • Quick Start
  • Concepts
  • Developer Guides

@github-project-automation github-project-automation bot moved this to 📌 Triage in FS Oct 20, 2025
@rjan90 rjan90 moved this from 📌 Triage to 🔎 Awaiting review in FS Oct 20, 2025
Copy link

@timfong888 timfong888 left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I made some suggestions, none earth shattering but for clarity and priority:

  1. Payment Rails: when I read it, the flexibility sounds like I, as the developer, can pay flexibility for the warm storage service; even if we could, I don't think that's what they want, it adds cognitive load. My understanding is they can set up rails for services they offer to their clients, so it's like a way to enable billing to customers for their own services.

  2. Related to payment rails: a core goal and metric is exposure of their customers to pay directly for the storage as a preferred mechanism. If we could nudge that way in the text and example.

  3. The rest are minor organizational and text changes.

@github-project-automation github-project-automation bot moved this from 🔎 Awaiting review to ⌨️ In Progress in FS Oct 22, 2025
@longfeiWan9
Copy link
Collaborator Author

@timfong888 Thank you for the review. I addressed your comments with some small changes.

Overall, this PR adds an intro section for POC.

  • We will use Quick Start for developers to learn how to use Synapse quickly
  • How developers will use Rails to pay - this will be covered in the developer guide section.
  • Flexible payment models mean developers can pay for Filecoin warm storage more flexibly from the Filecoin pay side. For example, fix rate, pay as you go, etc. We do not consider how the developers will bill their customers.

Let's focus on the "about" and "why" of FOC content to ensure we are explaining FOC correctly and excitingly.

@longfeiWan9
Copy link
Collaborator Author

@rvagg Why is this PR being closed ?

@rjan90
Copy link
Collaborator

rjan90 commented Oct 28, 2025

The PR here: #344 marked "Closes 331", so when it got merged GH automatically closed this.

But the number was a typo, will reopen

@rjan90 rjan90 reopened this Oct 28, 2025
@github-project-automation github-project-automation bot moved this from 🎉 Done to ⌨️ In Progress in FS Oct 28, 2025
@github-project-automation github-project-automation bot moved this from ⌨️ In Progress to 🎉 Done in FS Oct 29, 2025
@hugomrdias hugomrdias reopened this Oct 30, 2025
@github-project-automation github-project-automation bot moved this from 🎉 Done to ⌨️ In Progress in FS Oct 30, 2025
@Kubuxu Kubuxu self-requested a review November 4, 2025 17:14
@longfeiWan9 longfeiWan9 merged commit 0dd2c79 into FilOzone:master Nov 6, 2025
2 checks passed
@github-project-automation github-project-automation bot moved this from ⌨️ In Progress to 🎉 Done in FS Nov 6, 2025
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

Status: 🎉 Done

Development

Successfully merging this pull request may close these issues.

Docs: Introduction

5 participants