Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Chad edits #24

Open
wants to merge 3 commits into
base: main
Choose a base branch
from
Open

Chad edits #24

wants to merge 3 commits into from

Conversation

balazskreith
Copy link
Member

No description provided.

I'll have more. See the comments
I'll have more. See the comments
@netlify
Copy link

netlify bot commented Jan 5, 2022

✔️ Deploy Preview for keen-mirzakhani-d40f5e ready!

🔨 Explore the source changes: f700475

🔍 Inspect the deploy log: https://app.netlify.com/sites/keen-mirzakhani-d40f5e/deploys/61d59aced5f4ec00081fda15

😎 Browse the preview: https://deploy-preview-24--keen-mirzakhani-d40f5e.netlify.app


! Don't merge this to the main branch - for observerRTC team discussion

* CHANGELOG.MD - does that need to be updated?
Copy link
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

No we do not!

! Don't merge this to the main branch - for observerRTC team discussion

* CHANGELOG.MD - does that need to be updated?
* General commment: too many repos on github.com/ObserveRTC - can these be consolidated so it isn't so overwhelming to a newbie?
Copy link
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

That's a fair observation.

The main things are in:

  • observer: the collector
  • sfu-observer-js: client side implementation for sfu sampling
  • observer-js: the client-side implementation

less important:

  • website: which is this repo
  • schemas: for the schema changes. it can be merged with the observer repo
  • helm: for kubernetes helm
  • docker-compose for docker-compose examples

One idea:

  • rename observer-js to client-observer-js, and merge it with the integration repository
  • rename schemas-2.0 to schemas

Then we should pin the observer, sfu-observer-js, client-observer-js

cc: @pallab-gain


* CHANGELOG.MD - does that need to be updated?
* General commment: too many repos on github.com/ObserveRTC - can these be consolidated so it isn't so overwhelming to a newbie?
* What tool did you use to make your images?
Copy link
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I used plantuml!
The source of the images are here: https://github.com/ObserveRTC/observer/tree/master/docs/plantumls

* What tool did you use to make your images?
* I moved some items to a new quickstart page at /docs/get-started
* That quick start could use a a pre-requisites section and video or image showing the output
* "Observer" vs. "ObserveRTC" - these terms seems to be mixed up (or I lost track of what they are). ObserveRTC - refers to the entire project?
Copy link
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

yeah. ObserveRTC is for the project, and observer is the server side application collects the samples and generate reports.

* "Observer" vs. "ObserveRTC" - these terms seems to be mixed up (or I lost track of what they are). ObserveRTC - refers to the entire project?
* Observer is a specific elment of the project (the one that collects data)
* It would be better to list Jitsi, mediasoup, peerjs, etc. as sub-menu items with their own pages under client-integrations (and SFU integrations) -
* I tried this but couldn't figure out how to add an additional submenu in the sidebar - is that possible?
Copy link
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

which sidebar? the right-hand sidebar automatically created by the table of content of one page (like https://observertc.org/docs/overview/observer/)
the left hand sidebar reflects the folder structure you create. for example
if you create a folder under docs folder like client integration and you put an _index.md under it just like this you have a new category

* I tried this but couldn't figure out how to add an additional submenu in the sidebar - is that possible?
* Jitsi is missing from http://localhost:1313/docs/overview/client-integrations/
* Is this video still relevant? https://www.youtube.com/watch?v=RZ58vapWfUw&t=23s
* Do we need a separate site at https://observertc.github.io/ ?
Copy link
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I don't think so

* Jitsi is missing from http://localhost:1313/docs/overview/client-integrations/
* Is this video still relevant? https://www.youtube.com/watch?v=RZ58vapWfUw&t=23s
* Do we need a separate site at https://observertc.github.io/ ?
* What changes need to be made to this graphic? ![overview.png](overview.png)
Copy link
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

That is here: https://github.com/ObserveRTC/observer/blob/master/docs/plantumls/overview.puml
if you copy the content of that file for instance here: https://www.planttext.com/ you can see the image and modify the source

@@ -1,8 +1,8 @@
---
contributors: {'Balázs Kreith', 'Balazs Kreith'}
title: "Observer"
contributors: {'Balázs Kreith', 'Chad Hart'}
Copy link
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This page is generated by a script.
The original page is here: https://github.com/ObserveRTC/observer/blob/master/docs/user-manual.md
if you modify the source, the script automatically fetch your name as author and the generated page will contain it.

@@ -14,21 +14,22 @@ images: ["superficial-overview.png", "architecture.png", "object-hierarchy.png",

{{< img-simple src="superficial-overview.png" alt="Overview" >}}

Observer is a focuspoint for stats object origianted from different part of a WebRTC media services.
Observer consumes statistics generated from WebRTC end points like browsers and Selective Forwarding Units (SFUs).
Copy link
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I copied all of these changes to the source page: https://github.com/ObserveRTC/observer/blob/master/docs/user-manual.md

See the quickstart methodology below for adding this library to your web app.

### Janus Quickstart <a name="quickstart"></a>
### Janus Quickstart
Copy link
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

The source of the client-integration is the wiki page like https://github.com/ObserveRTC/integrations/wiki/Vonage-OpenTok-Integration I need to change the script fetching the integration repository and bundle together the integrations into one page.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

2 participants