You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
In the July 1 FOC WG Slack thread, Beck asked whether Curio maintainers agree that older filecoin-docs material should be integrated into Curio docs, since planned PDP installation / product improvements may change much of the tutorial content.
Current understanding
From the June 30 FOC WG discussion, my understanding is:
Detailed Curio installation, operation, PDP, and SP documentation should live in the Curio documentation.
filecoin.io and filecoin.cloud should provide a concise, high-level SP onboarding guide.
Those high-level guides should link directly to the relevant Curio docs.
Filecoin / FOC documentation should remain a thin entry or pointer layer.
Detailed content should not be duplicated across multiple sites because it will drift and become stale.
This issue is intended to track the Curio-side work needed to make that real.
Problems
PRs are being opened in non-Curio repos with detailed Curio/PDP content.
Those PRs can contain stale or soon-to-be-stale implementation details.
Curio maintainers may not see or review the content.
Operators who hit advanced setup or troubleshooting cases get Slack explanations instead of maintained URLs.
Agent/tooling workflows are less likely to discover the relevant guidance because it is not near the Curio source.
Steve take: the plan to make PDP installation easier and move more guidance into the product is good, but it does not remove the need for discoverable documentation covering advanced usage, troubleshooting, and non-happy-path deployments.
Proposed outcome
Curio should have a maintained documentation home for PDP SP setup and operations, including enough material that external docs can link into it instead of duplicating it.
This does not need to block future UX/product improvements. The docs can evolve as Curio improves.
Done criteria
Curio maintainers confirm the intended documentation home for detailed PDP SP guidance.
Curio docs contain current PDP SP setup / operational guidance, or a clear initial page with follow-up issues for missing sections.
Deprecated references such as pdpv0 are removed or clearly marked as obsolete.
Context
We need to close the loop on where Curio / PDP SP documentation lives and get the current documentation work out of limbo.
The current situation is creating repeated Slack discussion and stale cross-repo documentation:
pdpv0branch, which illustrates the drift problem when Curio operational guidance lives outside the Curio repo.Current understanding
From the June 30 FOC WG discussion, my understanding is:
filecoin.ioandfilecoin.cloudshould provide a concise, high-level SP onboarding guide.This issue is intended to track the Curio-side work needed to make that real.
Problems
Steve take: the plan to make PDP installation easier and move more guidance into the product is good, but it does not remove the need for discoverable documentation covering advanced usage, troubleshooting, and non-happy-path deployments.
Proposed outcome
Curio should have a maintained documentation home for PDP SP setup and operations, including enough material that external docs can link into it instead of duplicating it.
This does not need to block future UX/product improvements. The docs can evolve as Curio improves.
Done criteria
pdpv0are removed or clearly marked as obsolete.Related links