Missing "Documentation" link for some packages that have documentation

[daveverwer]

I just did a full run-through of all package pages that have doc_archives in the database to check for obvious errors, and found two packages without a "Documentation" link at all!

• Nifty-Markdown-Formatter (3CA0A035-46A1-4446-BC1E-D8B2697B7FC4)
• swift-mujoco (B38CD792-EAB2-40A3-9CC6-E173B5109842)

[daveverwer]

Interesting. I just investigated a little and both packages have empty JSON in their doc_archives field, which explains it!

It looks like swift-mujoco has a problem with their macOS build right now, and that's the platform being used for compilation. It looks to be something they are trying to fix, so it should all fix up when that resolves.

[daveverwer]

I'm not sure what's going wrong with Nifty-Markdown-Formatter. There's nothing obvious that I can see, and their builds seem to be successful.

Investigating further, this is the build log:

https://gitlab.com/finestructure/swiftpackageindex-builder/-/jobs/2644466709

Line 286 shows the problem:

xcodebuild: error: The workspace named "spi-builder-workspace" does not contain a scheme named "NiftyMarkdownFormatter". The "-list" option can be used to find the names of the schemes in the workspace.
[287](https://gitlab.com/finestructure/swiftpackageindex-builder/-/jobs/2644466709#L287)

However, their target in the .spi.yml does seem to be correct from a quick look at their Package.swift file.

[daveverwer]

However, their target in the .spi.yml does seem to be correct from a quick look at their Package.swift file.

Looks like their scheme is "Nifty Markdown Formatter" not "NiftyMarkdownFormatter":

Information about workspace "Nifty-Markdown-Formatter":
    Schemes:
        Nifty Markdown Formatter

[daveverwer]

I just found out that @finestructure already made a PR!

Converting this to a discussion where we can keep track of any other documentation failures.

[finestructure]

Here are my notes from investigating this issue this week - just hadn't gotten around to sharing them yet, sorry:

Failing docs

• DesignReviewer
  • was missing iOS platform, submitted PR
• GatheredKit
  • Error: No documentation target specified
  • https://gitlab.com/finestructure/swiftpackageindex-builder/-/jobs/2644359247
  • needs to be build on iOS
  • retriggered: https://gitlab.com/finestructure/swiftpackageindex-builder/-/pipelines/573883166
  • still: Error: No documentation target specified
  • run locally in builder test
  • platform key was iOS, needs to be ios
  • PR raised: Update .spi.yml JosephDuffy/GatheredKit#63
• MuJoCo
  • doesn't build on macos-spm, looks like a genuine build failure
• Nifty Markdown Formatter
  • https://gitlab.com/finestructure/swiftpackageindex-builder/-/jobs/2644347976
  • Error: No documentation target specified
  • needs iOS build
  • retriggered: https://gitlab.com/finestructure/swiftpackageindex-builder/-/pipelines/573890776
  • still no S3 doc archives, logs obscured, can't tell what happened
  • run locally in builder test
  • PR opened to fix: Update .spi.yml NiftyTreeStudios/Nifty-Markdown-Formatter#19
• Script.swift
  • fix doc upload Doc upload fails for Script.swift #1852
  • re-trigger after fix
• secp256k1
  • same parsing error as Script.swift above
  • PR to fix spi.yml Update .spi.yml 21-DOT-DEV/swift-secp256k1#206
  • re-trigger after fix
• StoreFlowable
  • same parsing error as Script.swift above
  • re-trigger after fix
• StreamChatVapor
  • error: no target named 'stream-chat-vapor-swift'
  • Opened PR: Update .spi.yml GetStream/stream-chat-vapor-swift#1