Hacktoberfest is a celebration of Open Source contributions and new developers are eagerly encouraged to join in. However, many projects require so much setup, which not only stressed me out but also discouraged me from considering contributing.
Of course, there is the Markdown Preview on GitHub - however, it only changes Markdown to HTML and doesn't render the whole page. You can't see how the changes you're introducing will look on the page unless you close, install dependencies, start the dev server.
But what if updating docs wasn't this complicated? Well, good news is that it doesn't have to be!
Below, I'm offering a workflow that helps you focus on the content update or creation, without the hassle of the setup. If you prefer to watch a video instead, I got you covered as well - check the end of the post!
Follow these three steps for a productivity hack:
- In the docs repository, find the file you want to edit - can be markdown, can be anything, really. Click "edit" icon.
- In the browser's address tab, add "pr.new" to the beginning of the URL address, press enter, and enjoy updating the content.
- Once you're happy with the result, propose the changes and submit a PR!
What you see above is a tool called Web Publisher. It is - and will remain - free for Open Source projects and for public repositories.
Web Publisher allows you to edit any file and see the changes rendered on the live preview. You don't have to do any special setup - you can even use it on your phone (on Chrome or Firefox). Now even the new developers can contribute their talents to Open Source by proofreading, translating, editing the text without the stress of the environment setup.
I have been using Web Publisher for weeks now and it really helped me a lot in my daily workflow. The other day I corrected a dead link on our page while waiting in line for an appointment 😂
You can either edit a page of any of the public repos or... Add your name to this page!
In case you'd like to see how I use the tool, see this video: