Document process of source package upload

I wanted to test whether Pulp could help us improve our Debian package management process.
The uploading and publishing of binary packages worked just fine and is reasonably well documented in the Package Uploads section of the documentation.

However, I'm now stuck on uploading source packages, which is essential for us.

I couldn't find any documentation on how to upload source packages. I understand that pulp-cli-deb might be limited to binary packages, but even with the REST API documentation it's difficult to understand how the process looks like.

After reading the API documentation and testing different things, I could only upload the source package components via the generic artifacts endpoint (/pulp/api/v3/artifacts/), as well as create a source package from the three components (via /pulp/api/v3/content/deb/source_packages/). I'm now stuck and unable to publish the source package.

Having an example of a source package in the documentation would be very helpful.

Start with the existing Package Uploads documentation and compare it with the source package API endpoints mentioned in the issue: /pulp/api/v3/artifacts/ and /pulp/api/v3/content/deb/source_packages/. Determine the missing upload and publish steps, then document a complete source-package example and verify that a reader can follow it from upload through publication.