📖 Improve collapsible code sections and formatting of tutorials

[camilamacedo86]

The following changes impact mainly the tutorials.
To review see:

• https://deploy-preview-5175--kubebuilder.netlify.app/cronjob-tutorial/cronjob-tutorial
• https://deploy-preview-5175--kubebuilder.netlify.app/multiversion-tutorial/tutorial

Documentation Improvements Summary

Changes

Content Cleanup:

• Hidden Apache License and Import blocks
• Hidden closing braces in tests
• Removed duplicate collapse markers
• Fixed extra } appearing outside code blocks

Label Updates:

• "Clock" → "Clock Code Implementation"
• "Go imports" → "Imports"
• "Validate object name" → "validateCronJobName() Code Implementation"
• "old stuff" → "Remaining code from "
• "The rest of Spec" → "CronJobSpec Full Code"

Related: #4862

[k8s-ci-robot]

[APPROVALNOTIFIER] This PR is APPROVED

This pull-request has been approved by: camilamacedo86

The full list of commands accepted by this bot can be found here.

The pull request process is described here

Needs approval from an approver in each of these files:

• OWNERS [camilamacedo86]

Approvers can indicate their approval by writing /approve in a comment
Approvers can cancel approval by writing /approve cancel in a comment

[vitorfloriano]

@camilamacedo86 I checked the preview and it seems that some copy buttons are still missing. See: https://deploy-preview-5175--kubebuilder.netlify.app/cronjob-tutorial/empty-main#every-journey-needs-a-start-every-program-needs-a-main

In code blocks that they are not missing, they are misplaced. See: https://deploy-preview-5175--kubebuilder.netlify.app/cronjob-tutorial/cronjob-tutorial#scaffolding-out-our-project

The custom CSS seems to be affecting how the copy buttons are displayed.

For testing, I checked out your PR and served the book using mdBook v0.4.40, then I deleted the custom CSS to see what happens and all the code blocks displayed the copy button properly (other parts broke, though 😅):

[camilamacedo86]

/hold

I will be looking on that
Good catcher.

[vitorfloriano]

Hi @camilamacedo86

I fixed the issue with the copy button and the license blocks. See #5184 and #5183.

[vitorfloriano]

@camilamacedo86 I'm working on improving the theme colors in the docs in a more maintainable manner and will share the PR soon. You gon' love it! 😍

So, I suggest you restore the changes in markers.css just so we don't have any conflicting CSS rules.

[vitorfloriano]

Hi @camilamacedo86

I fixed the issue with the copy button and the license blocks. See #5184 and #5183.

[camilamacedo86]

@camilamacedo86 I'm working on improving the theme colors in the docs in a more maintainable manner and will share the PR soon. You gon' love it! 😍

Regards the style here I will revert all and keep just the collapse ones
Just to share and thx a lot for the help.

[camilamacedo86]

@vitorfloriano
I think we can move forward with this one now.

Here’s what we’re doing here:

1. Hiding the license and Go imports (they don’t add value to the tutorials)
2. Fixing a few spots that weren’t properly closed

That said, we definitely need to work more on improving the snippet rendering — maybe revisit the layout of the collapse component and related details. Your help is very welcome !!!

[camilamacedo86]

/hold cancel