Okay/Spec - Revision history

Leah at 16:16, 21 December 2025

2025-12-21T16:16:03Z

← Older revision		Revision as of 17:16, 21 December 2025
Line 184:		Line 184:
	== messages ==		== messages ==
	== profiles ==		== profiles ==
	== subscriptions ==		== [https://www.youtube.com/shorts/IIISJgeTyPk subscriptions] ==
	== settings ==		== settings ==
	== pagination ==		== pagination ==

Blue Hair & their Fabulous Pronouns at 18:29, 4 July 2025

2025-07-04T18:29:48Z

← Older revision		Revision as of 19:29, 4 July 2025
Line 23:		Line 23:

	== controversies ==		== controversies ==

	* <s>What “server” means is kind of nebulous.</s>		* <s>What “server” means is kind of nebulous.</s>
	* What do we do about invalid HTML?		* What do we do about invalid HTML?
Line 140:		Line 139:
	\|-		\|-
	\|<code>ok-title</code>		\|<code>ok-title</code>
	\|Any non-void element, <code><nowiki><h1 /></nowiki></code>preferred.		\|Any non-void element, <code><nowiki><h1 /></nowiki></code> preferred.
	\|What the space is called in common parlance.		\|What the space is called in common parlance.
	\|-		\|-
	\|<code>ok-subtitle</code>		\|<code>ok-subtitle</code>
	\|Any non-void element, <code><nowiki><p /></nowiki></code>preferred.		\|Any non-void element, <code><nowiki><p /></nowiki></code> preferred.
	\|An extra bit of text that is displayed alongside the title in certain contexts.		\|An extra bit of text that is displayed alongside the title in certain contexts.
	\|-		\|-
	\|<code>ok-description</code>		\|<code>ok-description</code>
	\|Any non-void element, <code><nowiki><p /></nowiki></code>preferred.		\|Any non-void element, <code><nowiki><p /></nowiki></code> preferred.
	\|A long description of what the space is about.		\|A long description of what the space is about.
	\|}		\|}

Leah: /* directory */

2025-07-04T17:28:16Z

Leah: /* the directory */

2025-07-04T17:28:01Z

the directory

← Older revision		Revision as of 18:28, 4 July 2025
Line 164:		Line 164:
	The registration page allows clients to register their public key and [[Okay/Spec#profiles\|profile]] with the space.		The registration page allows clients to register their public key and [[Okay/Spec#profiles\|profile]] with the space.

	== ~~the~~ directory ==		== directory ==
	The '''room directory''' is represented using the <code>ok-rooms</code> [[Okay/Spec#michaelformats\|michaelformat]]. It contains the list of every room in a space. This list <span class="may">may</span> be [[Okay/Spec#pagination\|paginated]].		The '''room directory''' is represented using the <code>ok-rooms</code> [[Okay/Spec#michaelformats\|michaelformat]]. It contains the list of every room in a space. This list <span class="may">may</span> be [[Okay/Spec#pagination\|paginated]].

Leah: /* the directory */

2025-07-04T17:27:37Z

the directory

← Older revision		Revision as of 18:27, 4 July 2025
Line 169:		Line 169:
	A space's room directory <span class="must">must</span> be present in its [[Okay/Spec#ok-space\|ok-space]] element, either [[Okay/Spec#linking to stuff\|linked]] using the <code>ok-rooms</code> rel value or included inline.		A space's room directory <span class="must">must</span> be present in its [[Okay/Spec#ok-space\|ok-space]] element, either [[Okay/Spec#linking to stuff\|linked]] using the <code>ok-rooms</code> rel value or included inline.

	Rooms <span class="mustnt">must not</span> be included inline in the room directory.		Each room in the space <span class="must">must</span> be linked with a single <code><a /></code> element with the <code>ok-room</code> rel value. Rooms <span class="mustnt">must not</span> be included inline in the room directory.



	Here's an example of what a room directory might look like:<syntaxhighlight lang="html"><main class="ok-rooms">		Here's an example of what a room directory might look like:<syntaxhighlight lang="html"><main class="ok-rooms">

Leah: /* the directory */

2025-07-04T17:20:07Z

the directory

← Older revision		Revision as of 18:20, 4 July 2025
Line 165:		Line 165:

	== the directory ==		== the directory ==
	The '''room directory''' is represented using the <code>ok-rooms</code> [[Okay/Spec#michaelformats\|michaelformat]]. It contains a list of every room ~~contained within the~~ space. This list <span class="may">may</span> be [[Okay/Spec#pagination\|paginated]].		The '''room directory''' is represented using the <code>ok-rooms</code> [[Okay/Spec#michaelformats\|michaelformat]]. It contains the list of every room in a space. This list <span class="may">may</span> be [[Okay/Spec#pagination\|paginated]].

	A space's room directory <span class="must">must</span> be present in its [[Okay/Spec#ok-space\|ok-space]] element, either [[Okay/Spec#linking to stuff\|linked]] using the <code>ok-rooms</code> rel value or included inline.		A space's room directory <span class="must">must</span> be present in its [[Okay/Spec#ok-space\|ok-space]] element, either [[Okay/Spec#linking to stuff\|linked]] using the <code>ok-rooms</code> rel value or included inline.

Leah: /* the directory */

2025-07-04T17:19:24Z

the directory

← Older revision		Revision as of 18:19, 4 July 2025
Line 165:		Line 165:

	== the directory ==		== the directory ==
	The '''~~Room Directory~~''' is a list of every room contained within the space. This list <span class="may">may</span> be [[Okay/Spec#pagination\|paginated]].		The '''room directory''' is represented using the <code>ok-rooms</code> [[Okay/Spec#michaelformats\|michaelformat]]. It contains a list of every room contained within the space. This list <span class="may">may</span> be [[Okay/Spec#pagination\|paginated]].

	~~The URI of the~~ space's room directory <span class="must">must</span> be ~~linked~~ in its [[Okay/Spec#ok-space\|ok-space]] element using the <code>ok-rooms</code> rel value. Rooms <span class="mustnt">must not</span> be included inline.		A space's room directory <span class="must">must</span> be present in its [[Okay/Spec#ok-space\|ok-space]] element, either [[Okay/Spec#linking to stuff\|linked]] using the <code>ok-rooms</code> rel value or included inline.

			Rooms <span class="mustnt">must not</span> be included inline in the room directory.

	Here's an example of what a room directory might look like:<syntaxhighlight lang="html"><main class="ok-rooms">		Here's an example of what a room directory might look like:<syntaxhighlight lang="html"><main class="ok-rooms">

Leah: /* the directory */

2025-07-04T17:15:15Z

the directory

← Older revision		Revision as of 18:15, 4 July 2025
Line 168:		Line 168:

	The URI of the space's room directory <span class="must">must</span> be linked in its [[Okay/Spec#ok-space\|ok-space]] element using the <code>ok-rooms</code> rel value. Rooms <span class="mustnt">must not</span> be included inline.		The URI of the space's room directory <span class="must">must</span> be linked in its [[Okay/Spec#ok-space\|ok-space]] element using the <code>ok-rooms</code> rel value. Rooms <span class="mustnt">must not</span> be included inline.



	Here's an example of what a room directory might look like:<syntaxhighlight lang="html"><main class="ok-rooms">		Here's an example of what a room directory might look like:<syntaxhighlight lang="html"><main class="ok-rooms">

Leah: /* initiation */

2025-07-04T17:15:07Z

initiation

← Older revision		Revision as of 18:15, 4 July 2025
Line 156:		Line 156:

	== initiation ==		== initiation ==
	A client <span class="must">must</span> register itself with a space before it can ~~send messages to rooms~~.		A client <span class="must">must</span> register itself with a space before it can perform most actions.

	=== keys ===		=== keys ===
Line 167:		Line 167:
	The '''Room Directory''' is a list of every room contained within the space. This list <span class="may">may</span> be [[Okay/Spec#pagination\|paginated]].		The '''Room Directory''' is a list of every room contained within the space. This list <span class="may">may</span> be [[Okay/Spec#pagination\|paginated]].

	The URI of the space's room directory <span class="must">must</span> be linked in its [[Okay/Spec#ok-space\|ok-space]] element using the <code>ok-rooms</code> rel value.		The URI of the space's room directory <span class="must">must</span> be linked in its [[Okay/Spec#ok-space\|ok-space]] element using the <code>ok-rooms</code> rel value. Rooms <span class="mustnt">must not</span> be included inline.



	Here's an example of what a room directory might look like:<syntaxhighlight lang="html"><main class="ok-rooms">		Here's an example of what a room directory might look like:<syntaxhighlight lang="html"><main class="ok-rooms">
	<h1>Rooms on This Server</h1>		<h1>Rooms on This Server</h1>
	<ul>		<ul>
	<li><a href="/rooms/1" ~~class~~="ok-room">General</a></li>		<li><a href="/rooms/1" rel="ok-room">General</a></li>
	<li><a href="/rooms/evil" ~~class~~="ok-room">Evildoing Room (evil)</a></li>		<li><a href="/rooms/evil" rel="ok-room">Evildoing Room (evil)</a></li>
	</ul>		</ul>
	</main></syntaxhighlight>A room directory is still just a rat in a cage.		</main></syntaxhighlight>A room directory is still just a rat in a cage.

Leah at 17:10, 4 July 2025

2025-07-04T17:10:28Z

← Older revision		Revision as of 18:10, 4 July 2025
Line 3:		Line 3:
	}}{{spec\|Okay.}}		}}{{spec\|Okay.}}

			<p class="lede">
	'''Okay''' dares to ask the big questions. What if group chat was hypertext? What if discord let you write arbitrary HTML? What if protocols were bad?		'''Okay''' dares to ask the big questions. What if group chat was hypertext? What if discord let you write arbitrary HTML? What if protocols were bad?
			</p>

	== in summary ==		== in summary ==

← Older revision		Revision as of 18:28, 4 July 2025
Line 170:		Line 170:

	Each room in the space <span class="must">must</span> be linked with a single <code><a /></code> element with the <code>ok-room</code> rel value. Rooms <span class="mustnt">must not</span> be included inline in the room directory.		Each room in the space <span class="must">must</span> be linked with a single <code><a /></code> element with the <code>ok-room</code> rel value. Rooms <span class="mustnt">must not</span> be included inline in the room directory.



	Here's an example of what a room directory might look like:<syntaxhighlight lang="html"><main class="ok-rooms">		Here's an example of what a room directory might look like:<syntaxhighlight lang="html"><main class="ok-rooms">