Docs used by hub.darcs.net (eg the front page). Fork this and add questions/answers to make it better. (http://hub.darcs.net)

root

darcs hub documentation

Front page

frontpage.md holds the FAQ and other help content appearing on hub.darcs.net's front page. It (more precisely, the working copy) is re-rendered (from pandoc markdown + bare links + HTML tags) at page load time if the file has changed.

Finances

Project finances are tracked in darcshub.journal. You can run reports with hledger, eg:

Monthly income statement:

$ hledger -f darcshub.journal bal -MEATB revenues expenses
Balance changes in 2017q1:

                           ||  2017/01  2017/02  2017/03    Total  Average 
===========================++==============================================
 expenses:hosting          ||   $30.00   $30.00   $30.00   $90.00   $30.00 
 expenses:paypal           ||        0        0    $5.70    $5.70    $1.90 
 expenses:work             ||  $125.00  $375.00        0  $500.00  $166.67 
 revenues:donations:paypal ||        0        0 $-123.00 $-123.00  $-41.00 
---------------------------++----------------------------------------------
 profit(-)/loss(+)         ||  $155.00  $405.00  $-87.30  $472.70  $157.57 

Monthly balance sheet:

$ hledger -f darcshub.journal bal -MHE assets liabilities
Ending balances (historical) in 2017q1:

               ||  2017/01/31  2017/02/28  2017/03/31 
===============++=====================================
 assets:cash   ||    $-155.00    $-560.00    $-590.00 
 assets:paypal ||           0           0     $117.30 
---------------++-------------------------------------
               ||    $-155.00    $-560.00    $-472.70 

News

Notable changes at darcs hub (see also darcsden changes):

2017/3/16

  • show financial position on front page

2017/3/14

  • start tracking project finances
  • paypal donate button

2017/3/11

  • ssh server no longer requires KexAlgorithms +diffie-hellman-group1-sha1 workaround
  • docs updates
  • markdown files are now rendered as source, except for directory readmes
  • switch from github markdown to pandoc markdown, fixing line breaks
  • fix markdown angle bracket links

2014-2016

  • TBD

2013/10/25

  • When browsing a repo, its darcs get address is now displayed in the sidebar. Anonymous visitors see the http address, authenticated users see the ssh address.

2012

  • darcs hub goes live

2012 Roadmap

A possible roadmap for building a successful darcs repo hosting hub, to whatever extent we choose to do that. Tasks are grouped into phases, each depending on success with the preceding.

Phase 1, experimental ("get it working")

  • set up a modern hackable code branch DONE
  • set up a maintained instance with .darcs.net hostname DONE
  • announce to #darcs DONE
  • test small experimental instance DONE
  • make it useful (no problematic errors, manageable memory/cpu/disk load) DONE

Phase 2, alpha ("shakedown")

  • announce to darcs-users, haskell-cafe DONE
  • test for darcs development, public repo hosting DONE
  • more ui/stylecleanup DONE
  • make it robust (no errors, manageable load) (possible blockers include: 9 20 23 33 49 51 56 63 )

Phase 3, beta ("keep going...")

  • security
  • more data, load & stress testing
  • host official darcs repos, facilitate contributions to darcs
  • make it robust
  • maintain, enhance

Phase 4, production ("sustainability")

  • check status of darcsden.com, patch-tag.com
  • move to darcs.net server, set up team ownership & admin ?
  • make it robust
  • maintain, enhance

Non-goals:

  • v1 format repos will not be supported