Confusion with documentation folder names

[cmrd-senya]

Currently diaspora_federation has two documentation sets in it: API reference documentation and protocol documentation. API reference documentation is generated with yardoc and placed in /doc folder. Protocol documentation is rendered via jekyll and is placed under /docs folder. The folder names doc and docs make some confusion. I always forget which one is which and have to ls the folder to get it. Maybe we should change doc to api_doc or api_reference and docs to protocol_doc or protocol_documentation?

---

Want to back this issue? Post a bounty on it! We accept bounties via Bountysource.

[SuperTux88]

The /docs folder is fix, because GitHub pages can only use this folder, see here.

But feel free to change the output folder for yardoc. This documentation is published here and I hope they don't depend on our .yardopts file, so I think we can change it there.

[cmrd-senya]

Maybe the following can work: folder /docs as a root for the documenation, and /docs/protocol and /docs/api as subfolders?

[SuperTux88]

No. GitHub Pages is /docs folder or / folder ... nothing else.

[cmrd-senya]

If it was possible to tell jekyll to build site from a subfolder, then we could move it downwards to /docs/protocol. But I didn't find the way to do that. I'll check if it is possible to move the api reference to a separate folder.

[SuperTux88]

I'll check if it is possible to move the api reference to a separate folder.

You can set --output-dir in .yardopts. I hope www.rubydoc.info doesn't have a problem with that, because I have no control over that.