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: TODO: needs update

$ hledger -f darcshub.journal is -MB --pretty
Income Statement

                             ║ 2017/01  2017/02   2017/03  2017/04   2017/05  2017/06  2017/07  2017/08 
═════════════════════════════╬══════════════════════════════════════════════════════════════════════════
 Revenues                    ║                                                                          
─────────────────────────────╫──────────────────────────────────────────────────────────────────────────
 revenues:donations:gratipay ║       0        0         0        0    $-3.00   $-5.00  $-14.00  $-18.00 
 revenues:donations:paypal   ║       0        0  $-123.00  $-53.00  $-123.00  $-58.00  $-58.00  $-33.00 
─────────────────────────────╫──────────────────────────────────────────────────────────────────────────
                             ║       0        0  $-123.00  $-53.00  $-126.00  $-63.00  $-72.00  $-51.00 
═════════════════════════════╬══════════════════════════════════════════════════════════════════════════
 Expenses                    ║                                                                          
─────────────────────────────╫──────────────────────────────────────────────────────────────────────────
 expenses:hosting            ║  $30.00   $30.00    $30.00   $30.00    $30.00   $30.00   $30.00   $30.00 
 expenses:paypal             ║       0        0     $5.70    $2.18     $6.37    $2.78    $4.18    $2.68 
 expenses:work               ║ $125.00  $375.00  $2200.00  $900.00   $200.00        0  $300.00        0 
─────────────────────────────╫──────────────────────────────────────────────────────────────────────────
                             ║ $155.00  $405.00  $2235.70  $932.18   $236.37   $32.78  $334.18   $32.68 
═════════════════════════════╬══════════════════════════════════════════════════════════════════════════
 Total                       ║ $155.00  $405.00  $2112.70  $879.18   $110.37  $-30.22  $262.18  $-18.32 

Monthly balance sheet:

$ hledger -f darcshub.journal bs -M --pretty
Balance Sheet

               ║ 2017/01/31  2017/02/28  2017/03/31  2017/04/30  2017/05/31  2017/06/30  2017/07/31  2017/08/31 
═══════════════╬════════════════════════════════════════════════════════════════════════════════════════════════
 Assets        ║                                                                                                
───────────────╫────────────────────────────────────────────────────────────────────────────────────────────────
 assets:cash   ║   $-155.00    $-560.00   $-2790.00   $-3720.00   $-3950.00   $-3980.00   $-4310.00   $-4340.00 
 assets:paypal ║          0           0     $117.30     $168.12     $287.75     $347.97     $415.79     $464.11 
───────────────╫────────────────────────────────────────────────────────────────────────────────────────────────
               ║   $-155.00    $-560.00   $-2672.70   $-3551.88   $-3662.25   $-3632.03   $-3894.21   $-3875.89 
═══════════════╬════════════════════════════════════════════════════════════════════════════════════════════════
 Liabilities   ║                                                                                                
───────────────╫────────────────────────────────────────────────────────────────────────────────────────────────
───────────────╫────────────────────────────────────────────────────────────────────────────────────────────────
               ║                                                                                                
═══════════════╬════════════════════════════════════════════════════════════════════════════════════════════════
 Total         ║   $-155.00    $-560.00   $-2672.70   $-3551.88   $-3662.25   $-3632.03   $-3894.21   $-3875.89 

News

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

2018/11

• added Liberapay button & $10/week goal
• configured robots.txt to exclude most bot traffic, reducing cpu/disk io load
• fixed nightly darcs repo mirroring
• fixed a problem with nightly backups
• some discussion of darcs hub's future

2018/06

• darcs hub moved to its own VPS

2017/4/24

• darcs hub now uses TLS (https), courtesy of Let's Encrypt and Caddy

2017/3/22

• gratipay widget

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

Old Roadmap from 2012

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