Skip to content
This repository has been archived by the owner on Feb 3, 2023. It is now read-only.

Commit

Permalink
feat: Port architecture section to docusaurus
Browse files Browse the repository at this point in the history
  • Loading branch information
qdot committed Dec 21, 2022
1 parent 8834ac8 commit c14efc5
Show file tree
Hide file tree
Showing 10 changed files with 12 additions and 7 deletions.
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
# Client Architecture

![Buttplug Client Architecture Diagram](./client.png)
![Buttplug Client Architecture Diagram](/img/architecture/client.png)

Applications use clients to talk to Buttplug Servers. Let's go over what each part of clients and connectors do.

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -4,7 +4,7 @@ In this section, we'll cover Buttplug's core protocol and architectures. Getting

None of this chapter is programming language specific. While how these structures are implemented across programming languages may differ, the general idea will be the same across most systems. Any stark differences should be called out in documentation for the specific language implementations.

::: tip If you don't understand this section on first read, THAT'S OK!
:::tip If you don't understand this section on first read, THAT'S OK!

This guide is written in "theory then application" order. If you're more of an application than theory learner, that's fine! Just take a quick read through here, see what you pick up, then move on to the "Writing Applications" chapter and come back to this once you've gotten your hands (or other bits) dirty.

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -2,7 +2,7 @@

At the core of Buttplug is the Buttplug Protocol. This protocol is defined in the [Buttplug Spec](https://buttplug-spec.docs.buttplug.io).

::: tip Why is there a protocol specification?
:::tip Why is there a protocol specification?

It may seem a little silly to go to such formal lengths for a system for controlling sex toys, and it admittedly does introduce a level of formality that isn't seen outside of larger systems like web browsers. However, this serves a couple of functions:

Expand Down Expand Up @@ -58,7 +58,7 @@ Adding new functionality to Buttplug means adding new message, so when Buttplug

Message additions are a rather complicated process. Message addition procedure is outlined in the Inflating Buttplug section, but for now, just knowing these terms is enough so you can translate what project contributors are talking about when they discuss the spec and new messages.

::: tip Can Clients and Servers of different spec versions talk to each other?
:::tip Can Clients and Servers of different spec versions talk to each other?

Yes, in some cases.

Expand Down
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
# Server Architecture

![Buttplug Server Architecture Diagram](./server.png)
![Buttplug Server Architecture Diagram](/img/architecture/server.png)

As a developer using the Buttplug library for applications, your access to Buttplug Servers is limited to some setup methods. Otherwise, most of your interaction with a server will be via the Client API. It's still good to know a bit about what the inside of the server looks like though, if only so you can understand [what's being complained about on twitter](https://twitter.com/buttplugio).

Expand Down
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
# Buttplug Sessions and Components

![Buttplug Architecture Diagram](./architecture.png)
![Buttplug Architecture Diagram](/img/architecture/architecture.png)

## Buttplug Sessions

Expand Down
Original file line number Diff line number Diff line change
@@ -1,4 +1,4 @@
## Glossary
# Glossary

Just in case you don't want to go digging through the architecture section again, here's a quick list of common terms.

Expand Down
5 changes: 5 additions & 0 deletions sidebars.js
Original file line number Diff line number Diff line change
Expand Up @@ -22,6 +22,11 @@ const sidebars = {
label: 'Introduction',
items: ['intro/introduction', 'intro/how-to-read', 'intro/buttplug-ethics', 'intro/getting-help'],
},
{
type: 'category',
label: 'Strategies Against Buttplug Architecture',
items: ['architecture/intro', 'architecture/sessions-and-components', 'architecture/protocol-in-depth', 'architecture/client-in-depth', 'architecture/server-in-depth', 'architecture/terms'],
},
],
};

Expand Down

0 comments on commit c14efc5

Please sign in to comment.