feat: add docs for build in-obs

Related to packit/packit#2343

authors.yml

@@ -50,3 +50,9 @@ amulhern:
   email: [email protected]
   url: https://github.com/mulkieran
   image_url: https://github.com/mulkieran.png
+
+rxbryan:
+  name: Bryan Elee
+  email: [email protected]
+  url: https://github.com/rxbryan
+  image_url: https://github.com/rxbryan.png

docs/cli/build/in-obs.md

@@ -0,0 +1,28 @@
+---
+title: in-obs
+date: 2024-06-27
+sidebar_position: 5
+---
+
+# `packit build in-obs`
+
+Submit a build of the present content in the upstream or local repository to [OBS](https://build.opensuse.org/).
+
+## Requirements
+
+* SPEC file for the project placed in the repository.
+* Packit config file placed in the repository.
+
+
+
+## Tutorial
+
+1. [Place a config file for packit in the root of your upstream repository.](/docs/configuration/)
+
+2. The command below creates a tarball (archive) of your repository and commits it  along with the spec file to a package with a name corresponding to your upstream project on [OBS](https://build.opensuse.org/). The project defaults to home:$username:packit. Running packit build in-obs a second time creates a new commit in that package. 
+
+    ```
+    $ cd my/ustream/project/
+    $ packit build in-obs --project <project_name>
+    ```
+

docs/cli/build/index.md

@@ -16,6 +16,7 @@ Subcommand that groups all RPM build related commands together.
 * [`in-mock`](/docs/cli/build/in-mock)
 * [`in-copr`](/docs/cli/build/in-copr)
 * [`in-koji`](/docs/cli/build/in-koji)
+* [`in-obs`](/docs/cli/build/in-obs)
 * [`in-image-builder`](/docs/cli/build/in-image-builder)
 
 ## Help
@@ -32,5 +33,6 @@ Subcommand that groups all RPM build related commands together.
       in-copr  Build selected upstream project in Copr.
       in-image-builder  Create a VM image in Image Builder.
       in-koji  Build selected upstream project in Fedora.
+      in-obs   Build selected repository in Open Build Service
       in-mock  Build RPMs in mock using content of the upstream repository.
       locally  Create RPMs using content of the upstream repository.