summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
-rw-r--r--doc/contribute.mdwn25
-rw-r--r--doc/todo/Recommended_route_to_learning_Haskell__63__.mdwn2
-rw-r--r--doc/todo/Recommended_route_to_learning_Haskell__63__/comment_1_69bab2e1ab6382ba1149298e08ba659f._comment9
3 files changed, 34 insertions, 2 deletions
diff --git a/doc/contribute.mdwn b/doc/contribute.mdwn
index bc087348d..08b7bb473 100644
--- a/doc/contribute.mdwn
+++ b/doc/contribute.mdwn
@@ -7,6 +7,15 @@ This website is a wiki, so you can edit and improve any page.
Or, write a [[new_tip|tips]] explaining how to accomplish something with
git-annex.
+## advanced wiki editing
+
+To make larger changes to the website, you can
+`git clone git://git-annex.branchable.com/ git-annex` and will find the
+whole website source in `doc/`.
+
+You can even `git push` doc-only changes back without authentication,
+since it is a wiki!
+
## bug triage
People often file [[bugs]] on git-annex that are easily resolved by helping
@@ -35,5 +44,17 @@ You could work to improve the Android port (Java etc) or improve the
Javascript and CSS of the git-annex webapp, or work on porting libraries
needed by the Windows port.
-To send patches, either include the patch in a bug report (small patch)
-or put up a branch in a git repository containing your changes.
+To send patches, either include the patch in a [[bug|bugs]] report (small
+patch) or put up a branch in a git repository containing your changes.
+
+## learning some Haskell
+
+Want to learn some Haskell to get hacking on git-annex?
+
+As Haskell programs go, git-annex does not use too many advanced features.
+[Learn You A Haskell](http://learnyouahaskell.com/) will teach you enough
+to get started.
+
+Of course git-annex does use monads, and particularly the `Annex``monad
+which gives access to its state about the git repository as well as
+lower-level IO.
diff --git a/doc/todo/Recommended_route_to_learning_Haskell__63__.mdwn b/doc/todo/Recommended_route_to_learning_Haskell__63__.mdwn
index 5c55be3c3..9e1c30a94 100644
--- a/doc/todo/Recommended_route_to_learning_Haskell__63__.mdwn
+++ b/doc/todo/Recommended_route_to_learning_Haskell__63__.mdwn
@@ -1,3 +1,5 @@
Like many, I'm an experienced coder in procedural and object-oriented languages only.
Could you recommend a route to learning Haskell I could work on a little bit every month, such that I might eventually become familiar enough to hack on git-annex?
+
+[[done]]
diff --git a/doc/todo/Recommended_route_to_learning_Haskell__63__/comment_1_69bab2e1ab6382ba1149298e08ba659f._comment b/doc/todo/Recommended_route_to_learning_Haskell__63__/comment_1_69bab2e1ab6382ba1149298e08ba659f._comment
new file mode 100644
index 000000000..f5b13dadc
--- /dev/null
+++ b/doc/todo/Recommended_route_to_learning_Haskell__63__/comment_1_69bab2e1ab6382ba1149298e08ba659f._comment
@@ -0,0 +1,9 @@
+[[!comment format=mdwn
+ username="joey"
+ subject="""comment 1"""
+ date="2016-11-02T15:01:52Z"
+ content="""
+I'm taking this as an indication that [[/contribute]] needed some pointers
+for learning haskell, so have made some changes there that might answer
+your question, as well as others who see that page.
+"""]]