Skip to content

Conversation

Fabien-Chouteau
Copy link
Member

No description provided.

@Fabien-Chouteau Fabien-Chouteau requested a review from gusthoff July 24, 2025 16:52
"$(TEST_BUILDDIR)" $(SPHINXOPTS) $(O) -v -c "$(SPHINXCONF)"

BOOKS = $(wildcard $(CONTENT_DIR)/courses/*/.) $(wildcard $(CONTENT_DIR)/labs/*/.)
BOOKS = $(wildcard $(CONTENT_DIR)/courses/*/.) $(wildcard $(CONTENT_DIR)/labs/*/.) $(wildcard $(CONTENT_DIR)/booklets/*/.)
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I've just noticed now that this has been added to a new category called "booklets". Many years ago, we made the decision to remove the distinction between courses and books (or booklets) and call everything courses. In fact, other booklets — such as the "Ada for the C++ or Java Developer" booklet — have been adapted to fit the course format. I'd prefer not introducing a new category at this point in time.

Copy link
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

In terms of location in the repo, I am ok to move this new content in the courses dir.
As far as the presentation on the home page, I'd like to keep this book and the upcoming railway and space ones separated in the "AdaCore Technology Booklets" category.


# Figures, tables and code-blocks are automatically numbered if they
# have a caption.
numfig = True
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

In principle, this addition should be OK, but I'll evaluate the impact on the PDF version of other courses.

Copy link
Collaborator

@gusthoff gusthoff left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I've added a couple of general comments in the review.

Just as an offer, I could work on a couple of the adaptations that I'm suggesting / requesting in the comments. Just let me know!

@Fabien-Chouteau
Copy link
Member Author

Thanks @gusthoff , I made a first pass and I will continue next week.

@Fabien-Chouteau Fabien-Chouteau requested a review from gusthoff July 29, 2025 16:29
@gusthoff gusthoff added the new section Section using new content label Aug 8, 2025
@gusthoff gusthoff force-pushed the airborne-software-booklet branch from 59102fd to f12a584 Compare September 19, 2025 20:01
@gusthoff gusthoff force-pushed the airborne-software-booklet branch from f12a584 to c88fb1a Compare September 19, 2025 20:25
Correcting path to PDF / EPUB files	.
Aligning with structure from other courses.
@gusthoff gusthoff merged commit b061d8e into main Sep 20, 2025
9 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

new section Section using new content

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants