Resources for documentarians

Helping you craft a nice contribution to our docs!

How can I contribute to these docs?

Read all issues labeled documentation on opencollective/opencollective or all issues on opencollective/documentation and pick one to work on!

Checking if a page needs to be updated

As of November of 2019, a release notes tool is in the works. Until it is ready, your best resource for checking if something has changed on Open Collective is reading the recently closed issues on the opencollective/opencollective repository and checking if something needs to be updated!

Reviewing the current documentation

Did you find a typo, a broken link or image? Do you think that something could be explained better? Feel free to edit pages and submit a pull request!

Suggested tools

Linux
MacOS
Windows
Linux

Screen capture

Firefox Screenshots

Firefox offers a built-in tool that can either capture a portion of the page or the whole page you're currently viewing.

Flameshot

Flameshot is open-source software that helps you take screenshots easily and edit them as soon as you take them.

Shutter

If Flameshot doesn't work on your Linux installation, you may want to give Shutter a shot. Shutter is also an open-source software focused on screen capture, but it isn't on active development. However, the editing tool for Shutter needs a few additional packages related to GooCanvas, a canvas widget for GTK+, to work. They should be installed in the following order:

1. libgoocanvas-common (translations)

2. libgoocanvas3 (shared library)

3. libgoo-canvas-perl (Perl interface)

Once you installed all of them, kill all running instances of Shutter (using the killall shutter command) and launch it again. The Edit option should become available as soon as you capture a new screenshot!

Peek

Peek is open-source software that allows you to record portions of your screen and easily transform them into GIF, APNG, MP4, or WebM.

Extensions

GoodTwitter

GoodTwitter is an open-source extension to revert your current Twitter user interface to the old one. As of November of 2019, Twitter has unveiled their new interface and the embedding code they now offer doesn't work as intended on GitBook. To be able to embed tweets as seen on the Sustainer Resources page, you will need to access the old UI.

GoodTwitter is available for Google Chrome and Mozilla Firefox.

MacOS

Do you have any suggestions of tools documentarians could use on this OS? Please edit this tab!

Windows

Do you have any suggestions of tools documentarians could use on this OS? Please edit this tab!