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 / README.md

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
# darcs hub documentation

## Front page

[`frontpage.md`](/simon/darcshub-docs/frontpage.md) holds the FAQ and other help content appearing on
hub.darcs.net's [front page](http://hub.darcs.net).  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`](/simon/darcshub-docs/darcshub.journal).
You can run reports with [hledger](http://hledger.org), eg:

Monthly income statement:
```shell
$ 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:
```shell
$ 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](/simon/darcsden/browse/CHANGES.md)):

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

## 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](http://hub.darcs.net/simon/darcsden/issue/9)
    [20](http://hub.darcs.net/simon/darcsden/issue/20)
    [23](http://hub.darcs.net/simon/darcsden/issue/23)
    [33](http://hub.darcs.net/simon/darcsden/issue/33)
    [49](http://hub.darcs.net/simon/darcsden/issue/49)
    [51](http://hub.darcs.net/simon/darcsden/issue/51)
    [56](http://hub.darcs.net/simon/darcsden/issue/56)
    [63](http://hub.darcs.net/simon/darcsden/issue/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~~