darcs hub documentation

The official repo holding darcs hub docs is https://hub.darcs.net/simon/darcshub-docs. The front page's "past news" link points to the README.md committed there, eg. Changes to README.md must be pushed to that repo to appear on the site.

The front page is rendered differently, from a separate working copy of that repo (/home/darcshub/hub/docs/). Changes to frontpage.md there will appear without needing to be committed, facilitating quick edit-test. (But do commit and sync regularly to the official docs repo.)

frontpage.md holds the hub.darcs.net's front page content. In the working copy at /home/darcshub/hub/docs (more precisely, the working copy) is re-rendered (from pandoc markdown + bare links + HTML tags) at page load time if the file has changed.

Timeline

See also the front page for latest news, and darcsden changes for web app changes.

2025-07-30 mention Fedora policy change required for ssh setup

2019-02-05 You may enjoy raichoo's Darcs Book! (src)

2018/11/19 robots.txt update: more rules, more precise wildcards

2018/11/05 Some discussion of darcs hub's future

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

<!-- ## 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 

-->