TODO to fix in the documentation#

Todo

Add new explanation pages to cover:

  • architecture (server, worker, client)

  • work request scheduling (with work request status in all steps)

(The original entry is located in /builds/hertzog/debusine/docs/index.rst, line 28.)

Todo

Add new reference pages to cover:

  • debusine-client configuration file

  • debusine-server configuration file

  • debusine-worker configuration file

(The original entry is located in /builds/hertzog/debusine/docs/index.rst, line 57.)

Todo

Document all the (remaining) subcommands: * changepassword * createsuperuser * create_notification_channel * create_token * create_user * create_workspace * delete_expired_artifacts * delete_notification_channel * delete_tokens * edit_worker_metadata * list_notification_channels * list_users * list_work_requests * list_workers * list_workspaces * manage_notification_channel * manage_token * manage_user * manage_worker * manage_workspace * monthly_cleanup

(The original entry is located in /builds/hertzog/debusine/docs/reference/debusine-admin-cli.rst, line 23.)

Todo

Document all the subcommands.

(The original entry is located in /builds/hertzog/debusine/docs/reference/debusine-cli.rst, line 37.)

Todo

The remaining of this page comes straight from the former user/debusine-client and it needs to be reworked. We need a much simpler sequence of steps without any gory detail yet. The gory details needs to be moved in some howtos and/or reference pages.

I’d suggest to first schedule a “mmdebstrap” task that generates an artifact. Then inspect that artifact and download it.

Then we should use the (upcoming) debian-import command to upload a source package and then schedule a sbuild task for this source package.

We can throw in some screenshots of the corresponding views on the web interface. And that’s all.

(The original entry is located in /builds/hertzog/debusine/docs/tutorials/getting-started-with-debusine.rst, line 26.)

Todo

Make strong choices adequate to new persons. Ask to setup a bookworm VM and the document the minimal steps to perform in that VM. Use the repository from deb.freexian.com. Setup and enable a single worker and the first debusine user. Ask the user to connect to the web interface with its credentials.

Then propose to continue with a second tutorial where they can experiment with the debusine client interface.

(The original entry is located in /builds/hertzog/debusine/docs/tutorials/install-your-first-debusine-instance.rst, line 7.)