Home
Support Forums

Outdated Nanoc Docs

Hi :wave:t5:,

Just wanted to bring the support/doc folks attention to this Nanoc manual: https://www.netlify.com/blog/2016/03/08/a-step-by-step-guide-nanoc-on-netlify/

It’s extremely outdated and the deploy instructions are wrong. If someone follows the instructions in the manual they’ll come up against errors during the build process. Instead of setting the build command, users should leave that field blank but have the base directory set to the output folder of their build (which means they’ll need to push the output folder up to a remote git repo - this differs if they were using Nanoc with GitHub Pages or Bitbucket pages). As shown here:

The build will then only serve the files in the output folder and won’t have to run any build commands.

If these docs are open source and accept PRs from people, I’m happy to add a contribution. If not, I hope they get updated soon, I spent a very long time trying to debug this issue. Nanoc is also one of the Netlify supported static site generators so it’s helpful to have updated docs if it’s also going to be promoted.

Kindly,
Lola

Hi @lolaodelola,

Thank you for the information. The pages you’re talking about are from Netlify blog and not the docs. Docs are regularly checked and maintained. Blog posts sadly don’t get that same treatment.

Regardless, I’ve passed it on to the team and hoping to hear back from them soon. I’ll keep you posted on what happens.