Create documentation site (GitHub Pages or Netlify) using Docusaurus

[halcyondude]

Two things have bubbled to the top...

---

GraphQL Voyager

---

https://github.com/IvanGoncharov/graphql-voyager#graphql-voyager

---

Docusaurus

---

The docs are amazingly well done.

---

Resources

• https://docusaurus.io
• "explain like I'm 5: Docusaurus" (1 min)
• https://docusaurus.io/community/resources
• https://graphql-markdown.github.io
  • https://github.com/graphql-markdown/graphql-markdown
  • LIVE DEMO --> https://codesandbox.io/s/github/graphql-markdown/graphql-markdown-demo/tree/main?file=/graphql-markdown.config.js
  • (source for the demo) https://github.com/graphql-markdown/graphql-markdown-demo

---

Aside...proto!

https://protobuffet.com (https://github.com/protobuffet/docusaurus-protobuffet)

---

IDEA: This could be useful for #54 --> https://github.com/rdilweb/docusaurus-plugin-remote-content

A Docusaurus v2 plugin that downloads content from remote sources.

With this plugin, you can write the Markdown for your content somewhere else, and use them on your Docusaurus site, without copying and pasting.

---

[halcyondude]

There's also this...more minimalist. Perhaps this makes sense to include w/ dev setup...

https://github.com/2fd/graphdoc#readme

[AlexxNica]

I can help with this one, since I'm already doing it for https://github.com/nikas-org/filecoin-plus-docs.

Let's break it down into separate issues though; one for the documentation infra and another one for the graph visualization/plugins. WDYT?

[mohitvdx]

Hey i am new to the project, can someone help me out and tell how to start contributing?? @halcyondude

[AlexxNica]

Hey @mohitvdx, we're glad you're interested! We're still working on writing the contributors guide and the docs website, so my suggestion for now would be that you go through issues with the help wanted and good first issue labels. Also, check out more ways of getting involved in the how to contribute section.

[skushagra9]

Hey , I would love to work on this issue

[AbdoALPOP]

👋 Hey Matt,

I am interested in your task and available to start immediately.

I am experienced with Docusaurus.io, Nextra, Mkdocs, and markdown. I can provide you with a user-friendly guide.

Here are some of my live guides:

• Redstone
• RHQ
• WashMaster User Guide

I'm looking forward to hearing from you soon 😃 Contact me and let's get started.