Folder structure on Private Spec Repo differs from documentation

[winkelsdorf]

• [x] I've read and understood the CONTRIBUTING guidelines and have done my best effort to follow.

Report

What did you do?

I setup a private pod repo as documented on https://guides.cocoapods.org/making/private-cocoapods.html.

What did you expect to happen?

I expected to folder structure to follow the documentation, especially having a Specs folder in the repo root:

.
├── Specs
    └── [SPEC_NAME]
        └── [VERSION]
            └── [SPEC_NAME].podspec

What happened instead?

The pod spec is added to the root of the private repo.

.
├──[SPEC_NAME]
        └── [VERSION]
            └── [SPEC_NAME].podspec

CocoaPods Environment

Stack

   CocoaPods : 1.9.1
        Ruby : ruby 2.7.0p0 (2019-12-25 revision 647ee6f091) [x86_64-darwin19]
    RubyGems : 3.1.2
        Host : Mac OS X 10.15.3 (19D76)
       Xcode : 11.3.1 (11C504)
         Git : git version 2.25.2
Ruby lib dir : /Users/winkelsdorf/.rbenv/versions/2.7.0/lib
Repositories : trunk - CDN - https://cdn.cocoapods.org/ [redacted private repo]

Installation Source

Executable Path: /Users/winkelsdorf/.rbenv/versions/2.7.0/bin/pod

Plugins

cocoapods-acknowledgements       : 1.1.3
cocoapods-binary                 : 0.4.4
cocoapods-check                  : 1.1.0
cocoapods-deintegrate            : 1.0.4
cocoapods-keys                   : 2.1.0
cocoapods-packager               : 1.5.0
cocoapods-plugins                : 1.0.0
cocoapods-search                 : 1.0.0
cocoapods-static-swift-framework : 0.5
cocoapods-stats                  : 1.1.0
cocoapods-trunk                  : 1.4.1
cocoapods-try                    : 1.1.0
slather                          : 2.4.7

Project that demonstrates the issue

Create a private pod repo as documented on https://guides.cocoapods.org/making/private-cocoapods.html. See private repo folder structure afterwards.

[dnkoutso]

Probably an outdated documentation. PRs welcome! Moving to cocoapods.org GH issues.

[winkelsdorf]

@dnkoutso Yes, that's what I thought, too.

Just had been seeking clarification because of:

• CocoaPods Master Repo still using Specs directory itself
• Specs subfolder is mentioned all over the current sources (e.g. in the Cache https://github.com/CocoaPods/CocoaPods/blob/e5485d55addf291a61f1eae9bfc2f1fe1fe95b18/lib/cocoapods/downloader/cache.rb#L51).

I tried to find a behavior changing commit or related issue but without success.. 🤔

I would volunteer to create a PR for the docs when somebody can confirm the technical change.