diff --git a/doc/contribute.mdwn b/doc/contribute.mdwn index bc087348d8..08b7bb4734 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 5c55be3c3c..9e1c30a942 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 0000000000..f5b13dadcb --- /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. +"""]]