Skip to content

[#1336] In documentation add new tutorial since Mobile App Dev Days#1347

Merged
pylapp merged 4 commits intodevelopfrom
1336-in-documentation-add-new-tutorial-with-orange-branded-app
Mar 19, 2026
Merged

[#1336] In documentation add new tutorial since Mobile App Dev Days#1347
pylapp merged 4 commits intodevelopfrom
1336-in-documentation-add-new-tutorial-with-orange-branded-app

Conversation

@pylapp
Copy link
Copy Markdown
Member

@pylapp pylapp commented Mar 18, 2026 •
edited
Loading

Note: Please transform - [ ] into - (NA) in the description when things are not applicable

Related issues

#1336

Description

Add new tutorial to help local events and meetups to onboard people with a guided tutorial

Motivation & Context

Provide a second tutorial, more guided, more focused on branded apps

Types of change

  • New feature (non-breaking change which adds functionality)

Previews

Checklist

Contribution

Accessibility

  • (NA) My change follows accessibility good practices

Design

  • (NA) My change respects the design guidelines of Orange Unified Design System

Development

  • My change follows the developer guide
  • I checked my changes do not add new SwiftLint warnings
  • I have added unit tests to cover my changes (optional)

Documentation

  • My change introduces changes to the documentation and/or I have updated the documentation accordingly

Checklist (for Core Team only)

  • The evolution have been tested and the project builds for iPhones and iPads
  • Code review has been done by reviewers according to CODEOWNERS file
  • (NA) Design review has been done
  • (NA) Accessibility review has been done
  • (NA) Q/A team has tested the evolution
  • Documentation has been updated if relevant
  • Internal files have been updated if relevant (like CONTRIBUTING, DEVELOP, THIRD_PARTY, CONTRIBUTORS, NOTICE)
  • CHANGELOG has been updated respecting keep a changelog rules and reference the issues
  • The wiki has been updated if needed (optional)

pylapp added 3 commits March 18, 2026 15:45
@pylapp
docs: add new tutorial for onboarding, update discovery tutorial (#1336)
6b6e776 
Signed-off-by: Pierre-Yves Lapersonne <pierreyves.lapersonne@orange.com>
@pylapp
refactor: architecture of tutorials, project assets (#1336)
e77eb98 
Signed-off-by: Pierre-Yves Lapersonne <pierreyves.lapersonne@orange.com>
@pylapp
chore: various cleanings (#1336)
979044b 
Signed-off-by: Pierre-Yves Lapersonne <pierreyves.lapersonne@orange.com>
@pylapp pylapp requested a review from ludovic35 as a code owner March 18, 2026 16:05
@pylapp pylapp linked an issue Mar 18, 2026 that may be closed by this pull request
In documentation, add new tutorial with "Orange-branded" app #1336
Closed
3 tasks
@pylapp pylapp requested a review from Copilot March 18, 2026 16:05
@pylapp pylapp changed the title [#1336] In documentation add new tutorial since Mobile APp Dev Days [#1336] In documentation add new tutorial since Mobile App Dev Days Mar 18, 2026
Copilot AI reviewed Mar 18, 2026
View reviewed changes
Copy link
Copy Markdown

Copilot AI left a comment

Choose a reason for hiding this comment

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

Pull request overview

Adds new Swift DocC tutorials (Discovery + Onboarding) under OUDSThemesContract to better onboard newcomers during local events/meetups, and updates tooling/config to accommodate the new documentation assets.

Changes:

  • Add a new “Onboarding” tutorial with chapter content, images, and Swift sample snippets.
  • Add a new “Discovery” tutorial, migrate/rename related assets, and include a downloadable Xcode project ZIP.
  • Update SwiftFormat/SwiftLint exclusions and add a changelog entry for the new tutorial content.

Reviewed changes

Copilot reviewed 34 out of 106 changed files in this pull request and generated 7 comments.

Show a summary per file
File Description
fastlane/Fastfile Excludes the new DocC tutorial directories from SwiftFormat.
.swiftlint.yml Excludes the new DocC tutorial directories from SwiftLint.
CHANGELOG.md Adds release note entry for the new onboarding/meetups tutorial.
OUDS/Core/ThemesContract/Sources/_ThemesContract.docc/Tutorial_onboarding/tutorial-onboarding-1-package-and-librairies.tutorial Adds/updates onboarding chapter 1 content.
OUDS/Core/ThemesContract/Sources/_ThemesContract.docc/Tutorial_onboarding/tutorial-onboarding-2-nice-and-clear-view.tutorial Adds onboarding chapter 2 content.
OUDS/Core/ThemesContract/Sources/_ThemesContract.docc/Tutorial_onboarding/tutorial-onboarding-3-components-showcase.tutorial Adds onboarding chapter 3 content + assessments.
OUDS/Core/ThemesContract/Sources/_ThemesContract.docc/Tutorial_onboarding/tutorial-onboarding-4-going-further.tutorial Adds onboarding “resources/going further” chapter.
OUDS/Core/ThemesContract/Sources/_ThemesContract.docc/Tutorial_onboarding/resources/swift-samples/tutorial-onboarding-2-1.swift Onboarding step sample code (InfoCard skeleton).
OUDS/Core/ThemesContract/Sources/_ThemesContract.docc/Tutorial_onboarding/resources/swift-samples/tutorial-onboarding-2-2.swift Onboarding step sample code (InfoCard preview theming).
OUDS/Core/ThemesContract/Sources/_ThemesContract.docc/Tutorial_onboarding/resources/swift-samples/tutorial-onboarding-2-3.swift Onboarding step sample code (basic layout).
OUDS/Core/ThemesContract/Sources/_ThemesContract.docc/Tutorial_onboarding/resources/swift-samples/tutorial-onboarding-2-4.swift Onboarding step sample code (typography).
OUDS/Core/ThemesContract/Sources/_ThemesContract.docc/Tutorial_onboarding/resources/swift-samples/tutorial-onboarding-2-5.swift Onboarding step sample code (colors).
OUDS/Core/ThemesContract/Sources/_ThemesContract.docc/Tutorial_onboarding/resources/swift-samples/tutorial-onboarding-2-6.swift Onboarding step sample code (button).
OUDS/Core/ThemesContract/Sources/_ThemesContract.docc/Tutorial_onboarding/resources/swift-samples/tutorial-onboarding-2-7.swift Onboarding step sample code (spacing/grid margin).
OUDS/Core/ThemesContract/Sources/_ThemesContract.docc/Tutorial_onboarding/resources/swift-samples/tutorial-onboarding-2-8.swift Onboarding step sample code (light/dark scheme example).
OUDS/Core/ThemesContract/Sources/_ThemesContract.docc/Tutorial_onboarding/resources/swift-samples/tutorial-onboarding-3-1.swift Onboarding components sample (control components).
OUDS/Core/ThemesContract/Sources/_ThemesContract.docc/Tutorial_onboarding/resources/swift-samples/tutorial-onboarding-3-2.swift Onboarding components sample (badges).
OUDS/Core/ThemesContract/Sources/_ThemesContract.docc/Tutorial_onboarding/resources/swift-samples/tutorial-onboarding-3-3.swift Onboarding components sample (links/navigation).
OUDS/Core/ThemesContract/Sources/_ThemesContract.docc/Tutorial_onboarding/resources/swift-samples/tutorial-onboarding-3-4.swift Onboarding components sample (enum grouping).
OUDS/Core/ThemesContract/Sources/_ThemesContract.docc/Tutorial_onboarding/resources/swift-samples/tutorial-onboarding-3-5.swift Onboarding components sample (category selector).
OUDS/Core/ThemesContract/Sources/_ThemesContract.docc/Tutorial_onboarding/resources/swift-samples/tutorial-onboarding-3-6.swift Onboarding components sample (showcase view composition).
OUDS/Core/ThemesContract/Sources/_ThemesContract.docc/Tutorial_onboarding/resources/swift-samples/tutorial-onboarding-3-7.swift Onboarding sample (OUDSThemeableView integration).
OUDS/Core/ThemesContract/Sources/_ThemesContract.docc/Tutorial_onboarding/resources/swift-samples/tutorial-onboarding-3-8.swift Onboarding sample (OUDSTabBar integration).
OUDS/Core/ThemesContract/Sources/_ThemesContract.docc/Tutorial_discovery/tutorial-discovery-1-package-and-librairies.tutorial Adds discovery tutorial chapter 1.
OUDS/Core/ThemesContract/Sources/_ThemesContract.docc/Tutorial_discovery/tutorial-discovery-2-instanciate-theme.tutorial Updates chapter 2 metadata to include project files.
OUDS/Core/ThemesContract/Sources/_ThemesContract.docc/Tutorial_discovery/tutorial-discovery-3-use-first-components.tutorial Updates chapter 3 metadata + code/image references.
OUDS/Core/ThemesContract/Sources/_ThemesContract.docc/Tutorial_discovery/tutorial-discovery-4-use-other-components.tutorial Updates chapter 4 metadata + code/image references.
OUDS/Core/ThemesContract/Sources/_ThemesContract.docc/Tutorial_discovery/tutorial-discovery-5-styling-things.tutorial Updates chapter 5 metadata + code/image references.
OUDS/Core/ThemesContract/Sources/_ThemesContract.docc/Tutorial_discovery/tutorial-discovery-6-going-further.tutorial Renames image resources to the new discovery naming scheme.
OUDS/Core/ThemesContract/Sources/_ThemesContract.docc/Tutorial_discovery/resources/swift-samples/tutorial-discovery-2-1.swift Discovery step sample code (basic SwiftUI app).
OUDS/Core/ThemesContract/Sources/_ThemesContract.docc/Tutorial_discovery/resources/swift-samples/tutorial-discovery-2-2.swift Discovery step sample code (theme injection) — currently incomplete.
OUDS/Core/ThemesContract/Sources/_ThemesContract.docc/Tutorial_discovery/resources/swift-samples/tutorial-discovery-3-1.swift Discovery step sample code (scroll view) — currently incomplete.
OUDS/Core/ThemesContract/Sources/_ThemesContract.docc/Tutorial_discovery/resources/swift-samples/tutorial-discovery-3-2.swift Discovery step sample code (radio picker).
OUDS/Core/ThemesContract/Sources/_ThemesContract.docc/Tutorial_discovery/resources/swift-samples/tutorial-discovery-3-3.swift Discovery step sample code (checkbox).
OUDS/Core/ThemesContract/Sources/_ThemesContract.docc/Tutorial_discovery/resources/swift-samples/tutorial-discovery-3-4.swift Discovery step sample code (divider).
OUDS/Core/ThemesContract/Sources/_ThemesContract.docc/Tutorial_discovery/resources/swift-samples/tutorial-discovery-3-5.swift Discovery step sample code (switch + color scheme).
OUDS/Core/ThemesContract/Sources/_ThemesContract.docc/Tutorial_discovery/resources/swift-samples/tutorial-discovery-3-6.swift Discovery step sample code (link).
OUDS/Core/ThemesContract/Sources/_ThemesContract.docc/Tutorial_discovery/resources/swift-samples/tutorial-discovery-3-7.swift Discovery step sample code (button + loading).
OUDS/Core/ThemesContract/Sources/_ThemesContract.docc/Tutorial_discovery/resources/swift-samples/tutorial-discovery-4-1.swift Discovery step sample code (tags).
OUDS/Core/ThemesContract/Sources/_ThemesContract.docc/Tutorial_discovery/resources/swift-samples/tutorial-discovery-4-2.swift Discovery step sample code (chips).
OUDS/Core/ThemesContract/Sources/_ThemesContract.docc/Tutorial_discovery/resources/swift-samples/tutorial-discovery-4-3.swift Discovery step sample code (text inputs).
OUDS/Core/ThemesContract/Sources/_ThemesContract.docc/Tutorial_discovery/resources/swift-samples/tutorial-discovery-4-4.swift Discovery step sample code (colored surface).
OUDS/Core/ThemesContract/Sources/_ThemesContract.docc/Tutorial_discovery/resources/swift-samples/tutorial-discovery-5-1.swift Discovery step sample code (baseline app).
OUDS/Core/ThemesContract/Sources/_ThemesContract.docc/Tutorial_discovery/resources/swift-samples/tutorial-discovery-5-2.swift Discovery step sample code (spacing/sizing).
OUDS/Core/ThemesContract/Sources/_ThemesContract.docc/Tutorial_discovery/resources/swift-samples/tutorial-discovery-5-3.swift Discovery step sample code (raw token usage).
OUDS/Core/ThemesContract/Sources/_ThemesContract.docc/Tutorial_discovery/resources/swift-samples/tutorial-discovery-5-4.swift Discovery step sample code (semantic colors).
OUDS/Core/ThemesContract/Sources/_ThemesContract.docc/Tutorial_discovery/resources/swift-samples/tutorial-discovery-5-5.swift Discovery step sample code (elevation).
OUDS/Core/ThemesContract/Sources/_ThemesContract.docc/Tutorial_discovery/resources/swift-samples/tutorial-discovery-5-6.swift Discovery step sample code (borders).
OUDS/Core/ThemesContract/Sources/_ThemesContract.docc/Tutorial_discovery/resources/swift-samples/tutorial-discovery-5-7.swift Discovery step sample code (typography).
OUDS/Core/ThemesContract/Sources/_ThemesContract.docc/Tutorial_discovery/resources/swift-samples/tutorial-discovery-5-8.swift Discovery step sample code (tuning).
OUDS/Core/ThemesContract/Sources/_ThemesContract.docc/Tutorial_discovery/resources/swift-samples/tutorial-discovery-5-9.swift Discovery step sample code (font family).
OUDS/Core/ThemesContract/Sources/_ThemesContract.docc/Tutorial_discovery/resources/swift-samples/tutorial-discovery-5-10.swift Discovery step sample code (custom providers + tuning).
OUDS/Core/ThemesContract/Sources/_ThemesContract.docc/Tutorial_discovery/resources/OUDS-Discovery-Tutorial.zip Adds downloadable discovery tutorial Xcode project archive.
Comments suppressed due to low confidence (4)

OUDS/Core/ThemesContract/Sources/_ThemesContract.docc/Tutorial_discovery/tutorial-discovery-2-instanciate-theme.tutorial:1

  • projectFiles points to "OUDS-Discovery-Tutorial", but the resource added in this PR is OUDS-Discovery-Tutorial.zip. If DocC expects an exact resource filename, this will break the project download link. Consider aligning projectFiles with the actual resource name (including the .zip extension).
    OUDS/Core/ThemesContract/Sources/_ThemesContract.docc/Tutorial_discovery/tutorial-discovery-3-use-first-components.tutorial:1
  • projectFiles points to "OUDS-Discovery-Tutorial", but the resource added in this PR is OUDS-Discovery-Tutorial.zip. If DocC expects an exact resource filename, this will break the project download link. Consider aligning projectFiles with the actual resource name (including the .zip extension).
    OUDS/Core/ThemesContract/Sources/_ThemesContract.docc/Tutorial_discovery/tutorial-discovery-4-use-other-components.tutorial:1
  • projectFiles points to "OUDS-Discovery-Tutorial", but the resource added in this PR is OUDS-Discovery-Tutorial.zip. If DocC expects an exact resource filename, this will break the project download link. Consider aligning projectFiles with the actual resource name (including the .zip extension).
    OUDS/Core/ThemesContract/Sources/_ThemesContract.docc/Tutorial_discovery/tutorial-discovery-5-styling-things.tutorial:1
  • projectFiles points to "OUDS-Discovery-Tutorial", but the resource added in this PR is OUDS-Discovery-Tutorial.zip. If DocC expects an exact resource filename, this will break the project download link. Consider aligning projectFiles with the actual resource name (including the .zip extension).

You can also share your feedback on Copilot code review. Take the survey.

ludovic35
ludovic35 requested changes Mar 18, 2026
View reviewed changes
@pylapp
refactor: update samples et fix typos (#1336)
1e4c805 
Assisted-by: GitHub Copilot
Reviewed-by: Ludovic Pinel <ludovic.pinel@orange.com>
Reviewed-by: Copilot <198982749+Copilot@users.noreply.github.com>
Signed-off-by: Pierre-Yves Lapersonne <pierreyves.lapersonne@orange.com>
@pylapp pylapp merged commit 1b4be18 into develop Mar 19, 2026
19 checks passed
@pylapp pylapp deleted the 1336-in-documentation-add-new-tutorial-with-orange-branded-app branch March 19, 2026 09:24
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Reviewers

Copilot code review Copilot Copilot left review comments

@ludovic35 ludovic35 ludovic35 requested changes

Assignees

No one assigned

Labels

None yet

Projects

None yet

Milestone

No milestone

Development

Successfully merging this pull request may close these issues.

In documentation, add new tutorial with "Orange-branded" app

3 participants

@pylapp @ludovic35