Generated documentation contains docs from dependencies

[stephencelis]

If you view the following docs:

https://swiftpackageindex.com/pointfreeco/sqlite-data/main/documentation/sqlitedata

You can scroll down and see, after the repo's docs, uncategorized symbols (starting at "Classes"):

And there are a lot of them. Every symbol from every dependency seems to have surfaced.

I've seen this kind of buggy behavior in Xcode, as well, but generating the docs locally in the repo using the CLI produces what I expect:

swift package \
  --disable-sandbox preview-documentation \
  --target SQLiteData \
  --enable-experimental-overloaded-symbol-presentation

[finestructure]

Thanks for the report, Stephen. I'm not familiar with the parameter --enable-experimental-overloaded-symbol-presentation. Is this parameter related to the display in the sidebar? I.e. could it be that it's being ignored here?

[finestructure]

Also, I notice that you've chosen ios as the doc gen platform. The invocation there is different from swift package generate-documentation or preview-documentation and might be the cause. For iOS we're essentially running

xcodebuild \
	-skipMacroValidation \
	-skipPackagePluginValidation \
	docbuild \
	OTHER_DOCC_FLAGS=--emit-digest --enable-experimental-overloaded-symbol-presentation --source-service github --source-service-base-url https://github.com/pointfreeco/sqlite-data/blob/main --checkout-path $absoluteCheckoutPath \
	-scheme SQLiteData \
	-destination generic/platform=iOS

Now I'm not sure how to best validate the output this generates but perhaps you can run a web server in the output directory to see if it's rendering as expected?

[finestructure]

Oh, and iOS static hosting doc gen is a two step process. So the above output also needs to be processed:

docc process-archive transform-for-static-hosting \
	SQLiteData.docarchive \
	--output-path $outputPath \
	--hosting-base-path pointfreeco/sqlite-data/main

[stephencelis]

@finestructure Ah OK, that makes sense then! Xcode's DocC has this bug whereas the CLI does not. So we'll just not build iOS docs for now: pointfreeco/sqlite-data#200

Since this is an Apple bug that you can't control, going to close it out!