[bisq-network/bisq] Revise contributor / developer docs (#1924)

[Chris Beams]

This PR simplifies and restructures our developer documentation for ease of discovery and use. Major changes include:

 - Breaking up the root-level README into docs/build.md and docs/idea-import.md
 - A complete rewrite of CONTRIBUTING.md, loosely based on the structure of Bitcoin Core's own CONTRIBUTING.md.
 - Separating out `dev-setup.md` and `dao-setup.md`, as having the two sets of instructions intermixed was a bit overwhelming and confusing.
 - Removal of older files under scripts and misc. Each of these removals have been done in a dedicated commit for ease of reverting in case one is deemed important enough to keep around.

The motivation for putting these changes together was that I followed the instructions in dev-setup.md (formerly DEV_SETUP.md), and found them useful and accurate, but a bit too much with all the DAO information intermixed. That led to separating the two docs out as mentioned above, which in turn led to this more general overhaul. Altogether, I think these docs are now in good shape for guiding any new contributor in the right direction, giving them just what they need to know at each step, and hopefully keeping the instructions simple and enjoyable to follow along the way.

Note that there is now a bit of overlap between the docs here and the "contributor docs" section of https://docs.bisq.network. I think it may make sense to make docs.bisq.network our user-facing and non-dev contributor documentation portal, while keeping all things dev here. Particularly where class names, command line args and the like are mentioned, it's better to keep such docs in the repository, so as to keep things in sync with the code that's being described. Where higher-level contributor documentation, e.g. roles, proposals and compensation are concerned, it probably makes sense to keep documenting that at docs.bisq.network. /cc @m52go
You can view, comment on, or merge this pull request online at:

  https://github.com/bisq-network/bisq/pull/1924

-- Commit Summary --

  * Rename doc => docs
  * Remove outdated build doc
  * Remove misc/modena.css
  * Remove misc/protobuffer_dev_notes.md
  * Remove misc/ui-development-notes.md
  * Remove scripts/bisq-sn.cron.sh
  * Remove scripts/install_on_unix.sh
  * Remove scripts/run_bisq_via_vps.md
  * Move docs/CONTRIBUTING.md => CONTRIBUTING.md
  * Extract separate docs from main README.md
  * Rename DEV_SETUP.md => dev-setup.md
  * Extract dao-setup.md from dev-setup.md
  * Rename Bisq_DAO_regtest_setup.zip => dao-setup.zip
  * Clean up dao-setup.zip contents
  * Revise dev-setup.md
  * Revise dao-setup.md
  * Overhaul CONTRIBUTING.md

-- File Changes --

    M CONTRIBUTING.md (86)
    M README.md (44)
    D doc/Bisq_DAO_regtest_setup.zip (0)
    D doc/CONTRIBUTING.md (33)
    D doc/DEV_SETUP.md (161)
    D doc/misc/modena.css (3617)
    D doc/misc/protobuffer_dev_notes.md (246)
    D doc/misc/ui-development-notes.md (98)
    D doc/outdated/build.md (136)
    D doc/scripts/bisq-sn.cron.sh (46)
    D doc/scripts/install_on_unix.sh (22)
    D doc/scripts/run_bisq_via_vps.md (63)
    A docs/README.md (9)
    A docs/build.md (29)
    A docs/dao-setup.md (83)
    A docs/dao-setup.zip (0)
    A docs/dev-setup.md (92)
    A docs/idea-import.md (17)

-- Patch Links --

https://github.com/bisq-network/bisq/pull/1924.patch
https://github.com/bisq-network/bisq/pull/1924.diff

-- 
You are receiving this because you are subscribed to this thread.
Reply to this email directly or view it on GitHub:
https://github.com/bisq-network/bisq/pull/1924
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://lists.bisq.network/pipermail/bisq-github/attachments/20181114/5e99c508/attachment.html>