# Webaverse Doc Review Pt. 3

This looks at the "Engineering" section of the docs.

https://docs.webaverse.com/docs/engineering/webaverse-overview

# meta comments
- why is there "Quick Start Guide" and "Quick Start Basics"?
- App -> React -> Components -> Drag & Drop Module section is nested deep, is that necessary?
- docs link to youtube channel in footer, youtube channel has old branding and the discord links to metaverse makers discord

# Engineering

## Overview

> opensource

nit: open-source or open source

### System Representation

chart shows "Uses" on every line, it is redundant

curious how "AI" and "Local Storage" are used.

### Stack Requirements

#### Technologies

Are linking to quick start guides necessary here? I'm more curous about getting a short explanation of how each of these technologies are used in Webaverse.

#### Single Entry Point

Is knowing index.js is an entry point necessary? This is general, basic js stuff.

#### Simple & Basic App Setup

Just links to another page. Is this relevant to "Stack Requirements"?

#### Systems in Webaverse

I like the overview of different repos.

## Certificates

Seems like it should be under the quick start / getting started guide.

## Quick Start Guide

> To Use!

why exclamation mark?

### Directory Structure

> webaverse.js <-- This is the entry point of the Webaverse

this contradicts overview page that says index.js is the entry point.

## Screenshot System

> Screenshot.html

should be screenshot.html (lowercase)

## Vehicle System

> The Hovercraft is implemented in a separate project here: [Hovercraft Repo] (https://github.com/webaverse/hovercraft)

The link is not formatted correctly

## Totum

> Although this library does not provide game engine facilities, the API is designed to be easy to hook into game engines, and to be easy to drive using AIs like OpenAI's Codex.

The mention of using OpenAI at the end should be either expanded on or removed, it is unclear what that means

### Usage

> url: {URL of the asset that can be downloadable by the screenshot system} [Required]

this looks copy-pasted from screenshot page

> Promise:

why colon?

## Avatar System

### Avatar Setup

> Position
> Quaternion
> Start_url
> Dynamic

these should be lowercase

> Qaternions

misspell

### Object loading system

> .totum is the entry point for loading.

what does this mean? is .totum a file name?

## PhysX WASM Workflow

### Use it in Webaverse

> then replace it with "bin/geometry.wasm"

It looks like there is a dead image at the end of this line

> geometry.js suffix
> https://i.ibb.co/3yYjYm1/geom.png

I see this dead image twice

## Ethereum Backend -> Quick Start Guide

### Introduction

> The Webaverse Ethereum backend consists of a side chain that we mine using Proof-of-Stake.

Is this true? I think it is ran as proof-of-authority if a label is used. Who is staking on the sidechain?

### Blockchains

> http://ethereum1.exokit.org:8545

might be better to point to these at a webaverse.com domain

### Reversal

> uses a **differnt** endpoint than last time

typo

## NFT Voucher Library

I don't fully understand what this is used for.
## Sidechain MetaMask Setup

An easier way to achieve this is to use [EIP-3085](https://eips.ethereum.org/EIPS/eip-3085) to prompt users to add the network to their wallet. Example, look at chainlist: https://chainlist.org/

## Smart Contracts Integration Module
It looks like this page overlaps with NFT Voucher Library page?

> The IPFS **contend** ID

typo

> Stringified

why capitalized?

## Ethereum Bot -> Quick Start Guide

> Quick Start Basics

why link to this page on this page?

### Add to your server

> https://discord.com/oauth2/authorize?client_id=758956702669209611&permissions=0&scope=bot

It looks like this links to an outdated bot

## Preview -> Quick Start Guide

This seems like a duplicate of the "Screenshot System" page.

## Setup Custom Host Guide

Why is this here? It doesn't mention anything Webaverse specific. It's just a guide to edit host file.

## Quick Start Basics

This should be higher up in the list of docs, not at the bottom.

### Setup Cutom Host

This explains why there is a "Setup Custom Host Guide", this section should probably be on that page.

> Cutom

typo