Metion in documentation that gitlab pages works only with "public" directory
Today I run into somehow confusing "pages:gitlab pages failed to extract" problem on a try to publish my custom static pages with gitlab.io. It turned out that I'm not the only with the similar problem (many similar issues exist). After some reading I have found a comment by @ayufan that:
One of the requirements is that the folder name has to be
public/
, you cannot use a different folder for the purpose of deploying GitLab Pages.
Unfortunately I haven't found it in the "Getting started with GitLab pages" series. I would be good to mention there that that constrain exists (or if possible to remove it).