commons-issues mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From "Bruno P. Kinoshita (Issue Comment Edited) (JIRA)" <j...@apache.org>
Subject [jira] [Issue Comment Edited] (FUNCTOR-4) Add easily accessible, user-friendly examples
Date Fri, 04 Nov 2011 16:23:51 GMT

    [ https://issues.apache.org/jira/browse/FUNCTOR-4?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=13144105#comment-13144105
] 

Bruno P. Kinoshita edited comment on FUNCTOR-4 at 11/4/11 4:22 PM:
-------------------------------------------------------------------

Added a patch with some examples for review. 

Also uploaded the site to http://www.kinoshita.eti.br/public_files/site/examples.html, so
you can see it in your browser too. 

- Added links to javadoc, just like DBTUtils does
- Added examples for Predicate, Function and Procedure, following the order that they appear
in the main page
- Added an extra example that combines the three functors with generator and composite functors
- Removed the information on how to build
- Moved the practical part (and more advanced) to the bottom of the page, so the reader may
already have some notion on the basics before reading it

Seems like the links to all the code katas are being redirected to http://pragdave.pragprog.com/.
Not sure if they are available somewhere else or should be removed/updated.

I'm learning functional programming to use Functor in another open source project, so forgive
me in case there are any mistakes. Feel free to modify the patch, criticize or propose changes.
No hard feelings :-) 

Cheers, have a great WE.

Bruno P. Kinoshita
                
      was (Author: kinow):
    Added a patch with some examples for review. Thanks, Bruno P. Kinoshita
                  
> Add easily accessible, user-friendly examples
> ---------------------------------------------
>
>                 Key: FUNCTOR-4
>                 URL: https://issues.apache.org/jira/browse/FUNCTOR-4
>             Project: Commons Functor
>          Issue Type: Improvement
>            Reporter: Bruno P. Kinoshita
>            Priority: Minor
>         Attachments: FUNCTOR-4.patch
>
>
> Perhaps we could add some pages with examples to the project site? 
> As pointed by Emmanuel Bourg, at moment the examples point directly to classes in the
SVN.  We could add some basic examples and also point to sample code in the SVN, something
similar to what is done in DBUtils [1] and Commons-Pool [2].
> I'm reading FP for Java Developers, there are some basic examples that could be implemented
using Functor and put in the Examples page (I believe grand part is already implemented in
the tests classes).
> [1] http://commons.apache.org/dbutils/examples.html
> [2] http://commons.apache.org/pool/examples.html

--
This message is automatically generated by JIRA.
If you think it was sent incorrectly, please contact your JIRA administrators: https://issues.apache.org/jira/secure/ContactAdministrators!default.jspa
For more information on JIRA, see: http://www.atlassian.com/software/jira

        

Mime
View raw message