we need a 'quick-start' document about docs HOT 7 CLOSED

It should also contain sections on troubleshooting the build process:

1. about seccomp
2. effective bug/error reporting and how to get help
3. system quirks, how to enable ipv6 system-wide and for various browsers

Furthermore, we should explain what is on the network

1. HypeIRC, for development purposes (link to relevant channels (#cjdns, #documentation)
2. an up to date list of popular resources on the network (this is always a problem)
3. an explanation of what we are using for DNS (most people think hypeDNS still exists)
4. how to stay up to date (maybe with a list of RSS/atom/similar feed protocols that are provided by independent sites?

from docs.

Hi Ansuz,

Check https://github.com/bitonator/docs/blob/quickstart/quickstart.md and let me know what you think.

Maha

from docs.

Looks great!

A few little things:

Did you get chrome to work? Last time I checked there were issues because of this bug feature.

re:

See you at Hyperboria!

I'd s/at/on.

Finally, re: installing, we should link to a troubleshooting.md which lists common issues, directs people to IRC, and specifies what details they should share to get help. We can take care of that when we have such a document ready, of course.

Link to some instructions for fixing chrome, if possible, and fix the last line, and I'd say it's good for a PR.

from docs.

Chrome works fine, no settings changes needed, I'm on a Mac though, and that bug fix is reported on Windows, so not sure if that makes a difference.

s/at/on - done and pushed.

Fixing Chrome, will comb the docs for this and add.

Regarding the troubleshooting.md, I guess we'll have to collect all issues first, maybe just a text file dump from which I can write the doc.

from docs.

Chromium (Arch and Ubuntu) and chrome on linux (tested on Ubuntu) stopped working for me a while back, while I used to be able to --enable-ipv6 at launch time. I prefer firefox anyway, though, so I didn't put too much time into it. Good to know it's not broken everywhere.

I'll see about writing up common issues somewhere accessible and we can see about getting that troubleshooting doc going.

Thanks for your help! I'll pull your fork in shortly.

See you on Hyperboria!

from docs.

Merged.

from docs.

awesome!

A small issue...i thought --enable-ipv6 was a compile flag, not a command line argument.

I'll fix this in the docs and let you know.

from docs.