expand haskell section of contribute page
authorJoey Hess <joeyh@joeyh.name>
Wed, 2 Nov 2016 15:01:33 +0000 (11:01 -0400)
committerJoey Hess <joeyh@joeyh.name>
Wed, 2 Nov 2016 15:04:26 +0000 (11:04 -0400)
doc/contribute.mdwn
doc/todo/Recommended_route_to_learning_Haskell__63__.mdwn
doc/todo/Recommended_route_to_learning_Haskell__63__/comment_1_69bab2e1ab6382ba1149298e08ba659f._comment [new file with mode: 0644]

index bc087348d8ff8bd1ba15d41fe75cec7d2c4869f1..08b7bb473451cc607e55246d24eae937649eab07 100644 (file)
@@ -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.
index 5c55be3c3c78ddb95f61c51d8101358a48e3507e..9e1c30a942dadf095f6477d5a4920ab452b698d6 100644 (file)
@@ -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 (file)
index 0000000..f5b13da
--- /dev/null
@@ -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.
+"""]]