docs: remaining text referring to chiseled rocks in Flask and Django and chiseled rock section in FastAPI
Metadata
Current evaluation
Docs request for stale chiseled-rock text resolved by merged PR #1173 (commit 26ce6436): Flask, Django and FastAPI tutorials updated to bare-base flow, chiseled-rock sizes and reset commands removed.
Resolution: closed resolved
Reason: PR #1173 "docs: remove stale chiselled rock tutorial references" was merged as commit 26ce6436, touching docs/tutorial/flask.rst, django.rst and fastapi.rst. It closed #1167, implementing the reporter's scope (verified rock sizes incl.56 MB for Django, removal of obsolete chiseled-rock files/steps).
Evaluated by: mr-cal-bot
No scores available.
Issue body
### Check existing issues
- [x] I've verified that this request isn't described by any existing issues.
### Request
**Flask and Django:**
This relates to #1143 and the work done on #1151. There is still content that refers to the chiseling step in the Flask and Django tutorials. The following needs to be updated for both tutorials:
- At the bottom of the same section, the text states "The created rock is about 65/75 MB in size. We will reduce its size later in this tutorial." As now bare base is default, the size might have changed. This needs updating. There are no further chiseling steps so the next sentence should be removed.
- Under [Reset the environment](https://documentation.ubuntu.com/rockcraft/latest/tutorial/fastapi/#reset-the-environment), the command to remove the chiseled rock file should be removed as this file does not exist.
**FastAPI:**
#1097 set the default base of the tutorial to bare. This was not updated in the documentation. The following needs to be updated:
- Under [Pack the FastAPI app into a rock](https://documentation.ubuntu.com/rockcraft/latest/tutorial/fastapi/#pack-the-fastapi-app-into-a-rock), the `rockcraft.yaml `file created has the base set to bare. This needs to be updated in the example `rockcraft.yaml`.
- At the bottom of the same section, the text states "The created rock is about 75MB in size. We will reduce its size later in this tutorial." As now bare base is default, the size might have changed. This needs updating. There are no further chiseling steps so the next sentence should be removed.
- [Chisel the rock](https://documentation.ubuntu.com/rockcraft/latest/tutorial/fastapi/#chisel-the-rock) section should be removed, as it is no longer necessary.
- Under [Reset the environment](https://documentation.ubuntu.com/rockcraft/latest/tutorial/fastapi/#reset-the-environment), the command to remove the chiseled rock file should be removed. After the changes above have been applied, this file will not exist.
### Document location
https://documentation.ubuntu.com/rockcraft/latest/tutorial/django/
https://documentation.ubuntu.com/rockcraft/latest/tutorial/flask/
https://documentation.ubuntu.com/rockcraft/latest/tutorial/fastapi/
Evaluation history
| Date | Model | Scores | Action | Summary |
|---|---|---|---|---|
| stealth/space-bunny-alpha | — | closed resolved | Docs request for stale chiseled-rock text resolved by merged PR #1173 (commit 26ce6436): Flask, Django and FastAPI tutorials updated to bare-base flow, chiseled-rock sizes and reset commands removed. | |
| stealth/space-bunny-alpha | — | closed resolved | Merged PR #1173 (commit 26ce6436), removing obsolete chiseled-rock guidance and updating rock sizes in the Flask, Django, and FastAPI tutorials. | |
| qwen/qwen3.6-35b-a3b | — | — | Documentation updated to remove outdated chiseled rock references and adjust sizes/commands in Flask, Django, and FastAPI tutorials. Issue closed after a contributor volunteered to implement the changes. | |
| qwen/qwen3.6-35b-a3b | — | — | Closed with documentation updates agreed upon to remove obsolete chiseling references, update rock size notes, and align FastAPI tutorials with the bare-base default. | |
| qwen/qwen3.6-35b-a3b | — | — | Closed after a maintainer volunteered to apply the documentation updates. Changes remove obsolete chiseled rock references, update size metrics, and adjust reset commands across Flask, Django, and FastAPI tutorials to match bare-base defaults. | |
| qwen3.6-35b-a3b-mtp-q6 | — | — | Resolved by updating documentation to remove chiseling references and adjust sizes across Flask, Django, and FastAPI tutorials. A maintainer volunteered to implement the changes. |
Update history
No update history recorded yet.
Related work
-
Likely Fixed By:
canonical/rockcraft#1173
(confidence 98%)
Merged PR resolving #1167; commit 26ce6436 modifies all three tutorial files.
-
Related To:
canonical/rockcraft#1151
(confidence 90%)
Prior PR (commit 00dbdb1d) removing redundant chiselling steps from Flask/Django tutorials; this issue covers the leftovers.
-
Related To:
canonical/rockcraft#1097
(confidence 85%)
Set bare as default base for these extensions, causing the outdated base/size text in the FastAPI tutorial.
-
Related To:
canonical/rockcraft#1330
(confidence 60%)
Later commit eef25f2e further updated the FastAPI tutorial to remove the chiselling section.
Related issues
| Issue | Project | State | Summary | Similarity |
|---|---|---|---|---|
| #1173 docs: remove stale chiselled rock tutorial references | rockcraft | merged | Merged PR #1173 (commit 26ce6436), removing obsolete chiseled-rock steps from Flask, Django and FastAPI tutorials and updating verified rock sizes; it closed #1167. | |
| #1143 docs: remove chiseling section in Flask and Django rock tutorials | rockcraft | closed | Merged PR #1151 (00dbdb1d) removed redundant Chisel steps from the Flask and Django tutorials and clarified that a bare base produces a chiselled rock. | |
| #1151 docs: remove redundant chiselling steps from Flask and Django tutorials | rockcraft | merged | Merged PR #1151 in commit 00dbdb1d, removing redundant Chisel steps from Flask/Django tutorials and clarifying that base: bare already produces a chiselled rock. | |
| #1330 docs: Update FastAPI tutorial to remove chiselling section | rockcraft | merged | Docs PR #1330 merged as commit eef25f2e, deleting the obsolete FastAPI chiselling tutorial section since the FastAPI extension now defaults to the bare base (2 files, +2/-130). |