Navigation to main docs from a tutorial

Development Swift-DocC
1

We just started using interactive tutorials in our library and I've noticed that the tutorial homepage is kind of a dead end. There's no way to get back to the main documentation homepage, as far as I can tell.

For example, go here to see the homepage of a tutorial. I can't see anyway to navigate back to the main docs page.

Maybe this is by design if tutorials are seen as standalone pages, but it is a bit of a bummer to link to tutorials from the main docs and then have no way of going back. Is there a way to improve this with the tools that DocC offers today?

1 Like
2

I think you're right that there are two different navigation roots depending on if you're on a /tutorials/* page or /documentation/* page.

You might be able to guide folks back to the main page with a custom header, like the DocC docs do: swift-docc/header.html at main · apple/swift-docc · GitHub

2 Likes