Coder Social home page Coder Social logo

hubs-docs's Introduction

Hubs Docs

This repo is for the documentation for Hubs, and related products such as Hubs Cloud and Spoke.

The documentation is under active development. If there are any changes or updates you recommend, feel free to submit a pull request or let us know in our Discord Server.

This website was created with Docusaurus.

Docusaurus information

What's In This Document

Get Started in 5 Minutes

  1. Make sure all the dependencies for the website are installed:
# Navigate to the website directory
$ cd website

# Install dependencies
$ npm ci
  1. Run your dev server:
# Start the site
$ npm start

Directory Structure

Your project file structure should look something like this

my-docusaurus/
  docs/
    doc-1.md
    doc-2.md
    doc-3.md
  website/
    core/
    node_modules/
    pages/
    static/
      css/
      img/
    package.json
    sidebar.json
    siteConfig.js

Editing Content

Editing an existing docs page

Edit docs by navigating to docs/ and editing the corresponding document:

docs/doc-to-be-edited.md

---
id: page-needs-edit
title: This Doc Needs To Be Edited
---

Edit me...

For more information about docs, click here

Editing an existing blog post

Edit blog posts by navigating to website/blog and editing the corresponding post:

website/blog/post-to-be-edited.md

---
id: post-needs-edit
title: This Blog Post Needs To Be Edited
---

Edit me...

For more information about blog posts, click here

Adding Content

Adding a new docs page to an existing sidebar

  1. Create the doc as a new markdown file in /docs, example docs/newly-created-doc.md:
---
id: newly-created-doc
title: This Doc Needs To Be Edited
---

My new content here..
  1. Refer to that doc's ID in an existing sidebar in website/sidebar.json:
// Add newly-created-doc to the Getting Started category of docs
{
  "docs": {
    "Getting Started": [
      "quick-start",
      "newly-created-doc" // new doc here
    ],
    ...
  },
  ...
}

For more information about adding new docs, click here

Full Documentation

Full documentation can be found on the website.

hubs-docs's People

Contributors

baldator avatar brianpeiris avatar ctrlaltdavid avatar cvanmeurs avatar destynee avatar djay avatar dpx-designer avatar emclaren avatar gfodor avatar hrithikwins avatar infinitelee avatar irishgordo avatar j-conrad avatar johnshaughnessy avatar justinsteele avatar keianhzo avatar kimstacy avatar mariobodemann avatar matthewbcool avatar mikemorran avatar mikewyattdesign avatar misslivirose avatar netpro2k avatar robertlong avatar robinkwilson avatar takahirox avatar tanfarming avatar timvoronkin avatar varen8 avatar yalegria avatar

Stargazers

 avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar

Watchers

 avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar

hubs-docs's Issues

Domain Recipes: clarify allowed tlds for recipe 1 and other suggestions

General Description

As a reader of the "Domain Recipes" page I would like to have more clarity as to which tlds are ok for recipe 1 in order to have 0 doubt on whether I can buy a domain on Route 53 and get started.

In more details

As I was following the quick start guide and went through the domain recipes, in particular recipe 1, I found the documentation text to be just a tiny bit unclear on the fact that ".com" and ".link" are placeholders, and can be replaced by other top-level domains (tld), say ".io" or ".co", and since this step costs money, it could/should be improved.

Small hints that overall created my doubt:

  • ".link" is a very specific tld and is not necessarily a short one for what is supposed to be a short link
  • There is a bit on second-level domains and their specificity
  • Nowhere is it explicitly said that ".com" and ".link" are placeholders

I eventually went forward and can clarify that it is indeed perfectly ok to have a ".co" instead of ".com" for instance, while using Recipe 1.

Potential solution:

Currently, it writes:

Known bug + fix: Using a second level domain (.co.uk, .com.fr, etc)? Use Recipe 3.

Instead it could write:

".com" and ".link" can be replaced by other top-level domains at your convenience, eg. ".co", ".io" etc.
Known bug + fix: Using a second level domain (.co.uk, .com.fr, etc)? Use Recipe 3.

Aside from this, I also found:

  • It was hard to guess what the short-link link does exactly. Again, the ".link" example threw me off track for a sec since it's not that short and actually longer in the example ("myhub.com" vs "myhub.link"). An illustration (screenshot), and/or a reference to the Mozilla example could be helpful ("hubs.mozilla.com" vs "hub.link")
  • Someone on discord warning me that which tld to chose is also important for email server spam filters. In particular that ".space" was an issue for them
  • There are leftovers from drafts/todo in the doc? For instance

mysite.com set up on on Route 53 (?)

What is the (?) doing here?

  • While following Recipe 1 it was not clear when I should instantiate on a subdomain

I would be happy to submit a quick PR if someone doubles-check my language prior to it since I am not a native English speaker.

Let me know what I can clarify, in the meantime, my domains got approved, the transfer lock got disabled and my stack got successfully deployed ๐ŸŽ‰ ๐Ÿ˜„

Feedback from doc review

Add a welcome/introduction type article at the top of articles: orientate people first coming to that section, telling them what that documentation will allow them to achieve, who it is for, what it's about, etc. I'd advise putting a similar introduction type article at the top of all the sections, particularly:

Hubs Documentation - Consider "Hubs user guide" or similar since all of this documentation falls under the branch of 'Hubs Documentation'
Spoke Documentation - say what spoke is, who it is for, and what kinds of things you can do with it. What is the basic stuff people will want to try, and what are the most advanced bits to go onto later on
For Creators - May not be clear who this document is for
For Developers - Audience here may not be clear; it's also not clear if/how Hubs Cloud documentation is different than the general developer resources

Improve documentation on how to rebuild the client on AWS.

This came up on the Hubs Discussions forum so I'm recording it here for our records - Hubs-Foundation/hubs#2982

Thank you for the positive feedback! If I could throw in my bit on this, a simple document stating how to rebuild the client on AWS would go a long way for me. Thinking ahead, that would be really useful for many people. Right now, this document is not enough - its a vital subject, I get to half way the cant go forward after the prerequisites section: https://hubs.mozilla.com/docs/hubs-cloud-custom-clients.html
It would be nice to have a document stating the steps and the requirements.
Again, thank you for your interest.

Multilang

I'm interested in whether these docs are (or could be) multilang, and if so, how to contribute a Spanish translation to some sections.

Translate Hubs Mozilla for PT-BR

I want to know the possibility of translating Hubs Mozilla to the PT-BR language so that we Brazilians can use this platform in a more friendly way to our language.

Add Search Bar to Documentation

The code to add the search bar to the Hubs documentation site (which I believe is here: https://github.com/MozillaReality/hubs-docs/blob/master/website/siteConfig.js#L60) is present but currently commented out. When we last looked into adding the search to the site, the code worked fine for local instances of the codebase but had CSP issues when deploying to the live site.

Adding search would likely reduce the number of questions that we get through other channels, since users would have an easier time looking through the current documentation to find an answer for their issues.

Documentation of data regions in Hubs Cloud services

Some areas of the world have different requirements for where participant data can be stored and accessed from. We should have a document somewhere that outlines which services for Hubs Cloud are restricted to different regions, so that organizations with data storage and transmission requirements would be able to determine the viability of Hubs Cloud for specific use cases.

(Re-created from Hubs-Foundation/hubs-cloud#12)

The 500 error is displayed when clicking certain links from footer

[Affected Versions]:

  • Firefox Release 82.0.3
  • Chrome 87.0.4280.66

[Affected Platforms]:

  • Windows 10x64

[Prerequisites]:

[Steps to reproduce]:

  1. Click the "Docs" button from the navigation bar.
  2. Scroll to the footer of the page.
  3. Click the "Hubs Documentation" link.
  4. Observe the behavior.

[Expected results]:

  • The Hubs Documentation section is displayed.

[Actual results]:

  • The 500 error is displayed or the page remains in a loading state.

[Notes]:

  • This issue is also reproducible when clicking the "Spoke Documentation", For Creators", and "For Developers" links.
  • In Firefox the page remains in a loading state and on Chrome the 500 error is displayed.
  • I was not able to test this issue on MacOS, Linux or mobile devices.
  • Attached is a screen recording of the issue:
    FooterLinks (2)

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.