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.)