Page MenuHomePhabricator

[Cashtab] Adding stub dev docs with facebook docusaurus

Authored by josephroyking on Jan 27 2021, 19:21.


Group Reviewers
Restricted Project
rABC318e0b08c124: [Cashtab] Adding stub dev docs with facebook docusaurus

This addition was created with the command npx @docusaurus/init@latest init per It generates stub doc pages. This diff is intended to serve as a reference point for future customizations to developer docs for Cashtab extension, components, and bch-api.

Test Plan
cd web/docs
npm i
npm start

Navigate to localhost:3000 if it does not open automatically in browser. Observe default docusaurus stubs.

Diff Detail

rABC Bitcoin ABC
Lint Not Applicable
Tests Not Applicable

Event Timeline

Fabien requested changes to this revision.Jan 28 2021, 08:10
Fabien added a subscriber: Fabien.
  1. The test plan uses npm, but the doc uses yarn, and there is a yarn.lock file. Which one should I use ? Are both necessary ? Can we use the same package manager for our web projects to avoid adding dependencies ?
  2. I get the idea of setting up a template as an empty shell for building the docs, but I don't think it's a good idea to add all the docusaurus specific examples to our source tree, since they will all get deleted on next diff.
This revision now requires changes to proceed.Jan 28 2021, 08:10

Replacing yarn with npm, removing blog, replacing docusaurus stubs with cashtab stubs

Fabien requested changes to this revision.Feb 1 2021, 20:34
Fabien added inline comments.
19 ↗(On Diff #27461)


8 ↗(On Diff #27461)

switch to npm

9 ↗(On Diff #27461)

I don't think we are Facebook

95 ↗(On Diff #27461)

This file deserves an update, it's still full of example content

105 ↗(On Diff #27461)


1 ↗(On Diff #27461)

there are icons under /share/pixmaps

This revision now requires changes to proceed.Feb 1 2021, 20:34

Replace docusaurus stub settings and copy, add extension stub page

This revision is now accepted and ready to land.Feb 2 2021, 08:35