Skip to content

First version of the Airborne Software Booklet #1252

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Jump to bottom
Open
wants to merge 7 commits into
base: main
Choose a base branch
from
Open

First version of the Airborne Software Booklet #1252

wants to merge 7 commits into from

Conversation

Fabien-Chouteau
Copy link
Member

No description provided.

@Fabien-Chouteau Fabien-Chouteau requested a review from gusthoff July 24, 2025 16:52
gusthoff
gusthoff reviewed Jul 25, 2025
View reviewed changes
frontend/Makefile
@@ -271,7 +271,7 @@ site-testing: cleantest #
FRONTEND_TESTING=true $(SPHINXBUILD) -M html $(TEST_CONTENT) \
"$(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.

gusthoff
gusthoff reviewed Jul 25, 2025
View reviewed changes
gusthoff
gusthoff reviewed Jul 25, 2025
View reviewed changes
frontend/sphinx/conf.py
@@ -184,6 +184,13 @@ def get_file_from_conf_ini(path_to_file):
# The name of the Pygments (syntax highlighting) style to use.
pygments_style = 'sphinx'

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

gusthoff
gusthoff reviewed Jul 25, 2025
View reviewed changes
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
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Reviewers

@gusthoff gusthoff Awaiting requested review from gusthoff

At least 1 approving review is required to merge this pull request.

Assignees
No one assigned
Labels
new section Section using new content
Projects
None yet
Milestone
No milestone
Development

Successfully merging this pull request may close these issues.
2 participants
@Fabien-Chouteau @gusthoff