Skip to content

Restructure DocC documentation and add skills tutorial#70

Merged
albertodebortoli merged 1 commit intomainfrom
documentation/restructure-docc-and-add-skills-tutorial
Apr 12, 2026
Merged

Restructure DocC documentation and add skills tutorial#70
albertodebortoli merged 1 commit intomainfrom
documentation/restructure-docc-and-add-skills-tutorial

Conversation

@albertodebortoli
Copy link
Copy Markdown
Member

Description

  • Move end-user articles (Getting Started, Lucafile Configuration) from LucaCore.docc to LucaCLI.docc where they belong as CLI user-facing documentation
  • Rewrite LucaCore landing page to describe the library (protocols, architecture, components) rather than the CLI
  • Add a new "Installing Agentic Skills" tutorial in LucaCLI.docc covering agent configuration, Lucafile skills setup, installation, and management
  • Update LucaCLI, Meet Luca, and Getting Started pages to mention both tools and agentic skills
  • Remove incorrect npx skills add references from Lucafile.md and Skill.swift doc comment
  • Update Contributing.md doc preview command to cover both targets

Type of Change

  • Documentation

How Has This Been Tested?

  • Manually tested locally (describe)
    • swift build passes
    • swift package --disable-sandbox generate-documentation --target LucaCLI succeeds
    • swift package --disable-sandbox generate-documentation --target LucaCore succeeds
    • No new warnings introduced (existing warnings about missing @Image in chapters and stale symbol refs are pre-existing)

Checklist

  • Swift code builds locally (swift build)
  • Code style / formatting respected
  • Documentation updated (README / comments)

CI Considerations

  • Affects build time notably
  • Requires new secrets / env vars
  • Alters release process

Breaking Changes?

  • No

Move end-user articles (Getting Started, Lucafile Configuration) from
LucaCore.docc to LucaCLI.docc where they belong. Rewrite LucaCore
landing page to describe the library rather than the CLI. Add a new
InstallingSkills tutorial covering agent configuration, Lucafile skills
setup, installation, and management. Update all pages to mention both
tools and agentic skills.
@albertodebortoli albertodebortoli added this to the 0.15.0 milestone Apr 12, 2026
@albertodebortoli albertodebortoli added the documentation Improvements or additions to documentation label Apr 12, 2026
@codecov
Copy link
Copy Markdown

codecov Bot commented Apr 12, 2026

Codecov Report

✅ All modified and coverable lines are covered by tests.

📢 Thoughts on this report? Let us know!

@albertodebortoli albertodebortoli merged commit a3ea0a6 into main Apr 12, 2026
3 checks passed
@albertodebortoli albertodebortoli deleted the documentation/restructure-docc-and-add-skills-tutorial branch April 12, 2026 17:57
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

documentation Improvements or additions to documentation

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant