feelin lazy

core/src/test/kotlin/io/bkbn/kompendium/core/util/TestModules.kt

@@ -35,6 +35,7 @@ import io.bkbn.kompendium.core.metadata.PutInfo
 import io.bkbn.kompendium.core.plugin.NotarizedRoute
 import io.bkbn.kompendium.json.schema.definition.TypeDefinition
 import io.bkbn.kompendium.oas.payload.Parameter
+import io.kotest.engine.extensions.SystemPropertyTagExtension.tags
 import io.ktor.http.HttpStatusCode
 import io.ktor.server.application.call
 import io.ktor.server.application.install
@@ -77,6 +78,7 @@ object TestModules {
  route(defaultPath) {
  install(NotarizedRoute()) {
  parameters = defaultParams
+ tags = setOf()
  get = GetInfo.builder {
  response {
  responseCode(HttpStatusCode.OK)

docs/plugins/notarized_route.md

@@ -66,8 +66,39 @@ install(NotarizedRoute()) {
 
 ## Operation Tags
 
-Operation tags work much like route tags, except they only apply to the operation they are defined in.
+Operation tags work much like route tags, except they only apply to the operation they are defined in. They are defined
+slightly differently, as a function on the builder, rather than an instance variable directly.
+
+```kotlin
+install(NotarizedRoute()) {
+ get = GetInfo.builder {
+ tags("User")
+ // ...
+ }
+}
+```
 
 ## Operation Parameters
 
+Operation parameters work much like route parameters, except they only apply to the operation they are defined in. They
+are defined slightly differently, as a function on the builder, rather than an instance variable directly.
+
+```kotlin
+install(NotarizedRoute()) {
+ parameters(
+ Parameter(
+ name = "a",
+ `in` = Parameter.Location.path,
+ schema = TypeDefinition.STRING,
+ ),
+ Parameter(
+ name = "aa",
+ `in` = Parameter.Location.query,
+ schema = TypeDefinition.INT
+ )
+ )
+ // ...
+}
+```
+
 ## Defining Request and Response Bodies

playground/src/main/kotlin/io/bkbn/kompendium/playground/BasicPlayground.kt

@@ -70,6 +70,7 @@ private fun Route.documentation() {
  )
  get = GetInfo.builder {
  tags("")
+ parameters()
  summary("Get user by id")
  description("A very neat endpoint!")
  response {