This issue is about

• Man pages or command-line usage
• Website documentation
• Packaging
• Other

Describe the issue

The use of /etc/os-release for determining DISTRO is missing from the yadm.io website.

Now we have 3 binaries in npm and script which run necessary binary depends on the current platform.

There are 2 big problems with current behavior:

1. npm package size is huge (26 MB)
2. Node.js startup time is not great.

Solution:

1. postinstall script download necessary binary (many npm packages use this approac

I wish I could see stdout while Custom command is running.
https://github.com/skpm/skpm/blob/master/docs/notarization.md

Describe the bug
Repetitive loading have you waiting on gists loading.

To Reproduce
Steps to reproduce the behavior:

1. Go to Gists, see the loading circle
2. Click on local
3. Go back to gists, and a new loading circle appears

Expected behavior
I think the loaded gists should remain loaded even when going to local, and maybe have a refresh button if you want to pull new gi

There is a ton of documentation here and that's great, however, the first introduction to this tool is overwhelming and should be simplified. You may want to move some of the more stable documentation to the Wiki and reference it from the ReadMe.

The SCons file is quite "magical" and undocumented at the moment. I needed to find it to understand these points for example:

• how is a PCF file located? which is chosen if there are multiple?
• how are testbench files recognized and treated?
• how are verilog source files recognized and treated?

IMO the second two should be documented in the docs for apio sim and apio build respectiv

The current workflow to release this project does not include any release notes.
To document for us and the public audience we should use GH releases and set up release notes similar we do in in skipper, for example: https://github.com/zalando/skipper/releases/tag/v0.10.122

Idea:
I think we should have a 0.x.y release and document that it's not possible to really run this project as it is, wi