Hacker News new | ask | show | jobs
by mrwnmonm 1710 days ago
Thanks for the reference. But if you would allow me to be honest, I don't want to even read that page. I have tons of things to do, I want to just write. I am using Gitbook right now but I like Docusaurus more. I hope if someone would enhance the design a little bit, and give me the ability to add custom CSS if I really wanted to. And I am happy to pay for it a reasonable price.

I could actually just install it locally, do whatever I want, generate the static files, and add it to my project. But I will have to maintain the installation (for a language that I don't use), keep it updated, maybe fight with npm for sometime, and also being familiar with Docusaurus itself.

And I prefer a service focused on this problem, than using a general (even if easier) solution like Netlify.

At the end of the day, I think I will do what you said, because that service doesn't exist now :)

1 comments

Check out Netlify, I think you'd really like its build previews. Basically go through a teeny bit of pain once to set it up and then all you have to do is push updated documentation files to github. Netlify will detect the changed files, rebuild your site using docusaurus, and send you a URL to hit to immediately view the updated docs as a preview. If you like it you click a button and make it live, otherwise you go back and edit and revise. You don't need to janitor or babysit a local install after the initial setup. Check out more info in some of their tutorials: https://www.netlify.com/blog/2016/09/29/a-step-by-step-guide...
I will, thanks very much.