Closed (fixed)
Project:
ICES
Component:
Documentation
Priority:
Major
Category:
Feature request
Assigned:
Issue tags:
Reporter:
Created:
16 May 2013 at 09:08 UTC
Updated:
12 Jun 2014 at 19:34 UTC
Jump to comment: Most recent, Most recent file
Comments
Comment #1
hongpong commentedVery simple readme file, lets see if this patch format works.
Comment #2
esteve.badia commentedApplied! Thanks!
I'm not really familiar with the contributing workflow in Drupal community. I just applied the patch and commited the changes from my Drupal user. I guess that's all. :-)
Comment #3
hongpong commentedDid a ton of coder cleaning in the bank forms inc file. I had some confusion about spacing (like, it seems to disagree with itself about some spacing rules). However many problems have been eliminated and tons of errors are gone now. I figure I should post a change this big for review, though I can merge it myself later.
I think two commits got in this patch and I may have to roll it again, if it doesn't merge.
Comment #4
esteve.badia commentedGreat job!
I've manually reviewed the patch and It seems all ok to me. Indeed the README.txt file also comes with this patch. The breaks after returns could be safely removed instead of adding a new empty line between them, but it isn't significant.
So, in my opinion, proceed to apply the patch to the master branch. Since I've modified also some lines of this file (adding an automatic new Drupal user for administering each new exchange), I prefer that you commit the changes so I can merge it to my local copy and commit. I promise I won't break the coding standards further :)
Comment #5
hongpong commentedOk, thanks for the approval!! I will merge it in promptly. Glad to help! I will toggle this bug # back to "Needs Review" when I have another patch along these same sorts of purposes. Will try to get it on there very shortly here today.
Comment #6
hongpong commentedOK after a little tweaking on my git environment, merges done for now. I think they are correct. I did one merge backwards but the result is OK.
Other code stuff: Before entering the project approval queue, We still need to change master branch into 7.x-1.x . See http://drupal.org/empty-git-master for Howto.
Also there is a need to sanitize some of the messages that are printed by the bank forms inc file - the coder warns that filter_xss() or similar should wrap the print statements. I didn't do any of that because I wasn't sure which was the correct sanitization filter. That was the primary security thing that popped up for me so far.
Comment #7
hongpong commentedMore coder cleanup stuff and comments for the bank install and bank logic PHP files. I can merge this in later after you look it over.
EDIT - got some rest, looked it over & merged it in.
Comment #8
hongpong commentedI did more code review on the bank logic inc file. Calling it a night for now, added a lot of todo documentation stubs in order to satisfy the coder module. I don't think any logic is changed but I might have made a typo or 2. Also kind of winged it on some function descriptions. However overall I think this gets rid of many notices. If it looks good to you I will merge later Tues.
Comment #9
hongpong commentedMore cleanup on the other bank files as well, the pages and theme inc files. I hope it's all right to just add little TODO doc stubs in order to keep coder happy. I saw the comments that more work is needed on these, but figure no harm in a little more code cleanup.
Comment #10
esteve.badia commentedReviewed and added some (and changed a bit a pair) function documentation comments.
Comment #11
hongpong commentedSweet, I applied it and merged to master. Plus I'm starting to understand this thing :)
I will keep trying to clean more files.
Comment #12
hongpong commentedThis might be the last coder patch to run for now. All the files except those test loader files have at least been looked over. One other thing is that Coder wants interfaces to have "Interface" in their name.
Comment #13
hongpong commentedI ran into some small issues when messing around. The default behavior when no exchanges or other data loaded needs to be tuned a little bit, and this helps.
Comment #14
hongpong commentedDid a little more digging and was able to fix menu callbacks for edit/delete accounts. Also made a stub for the account deletion callback. Added more help text in exchange form. Added a default new exchange in Barcelona. Rearranged the menu array to make it a little more logical. Made the google map link non-mandatory.
Maybe don't want to have the default new exchange settings in there, but it helps move along testing better.
Comment #15
hongpong commented... And just realized the same tweak should go on to the limits and transactions callbacks. Seems to be working nicely although the delete callback for limits still needs to be implemented :)
Comment #16
esteve.badia commentedReviewed! Great work! Only two points (updated patch)
Comment #17
esteve.badia commentedMissed to set the status tag to reviewed :o
Comment #18
hongpong commentedAlright it is merged in and committed hooray :) cc0ead4
Next I think I will look at coder compliance for private variables, or perhaps other error checking. I did not realize that about how the % callbacks work, thanks for the info! Or I am open to suggestions too definitely, no random task too small.
Comment #19
hongpong commentedHere are a bunch of cleanups. More ambitiously, changing camelcase private variables and attempting to rename Transaction to TransactionInterface including in the function arguments and documentation. And AccountInterface as well. Adding Interface definitely makes it easier for me to understand.
Comment #20
hongpong commentedOOps. Flag to review.
Comment #21
esteve.badia commentedThis patch is conflicting with the current master branch. I'll try to apply it manually. I'll try not to get hurt with it ;-)
Comment #22
esteve.badia commentedReviewed & commited :) Great work!
Comment #23
esteve.badia commentedDone a lot of code cleanup in order to pass the coder module exam. Now there isn't any coder notice except for several @see directives in
ces_bank.logic.incfile that I don't understand. I believe they are correct.Anyway, we can give it the OK. So perhaps we can start thinking about applying for drupal project. The tests (issue #1998104) are not exhaustive but they exist and test the most critical feature.
What do you think?
BTW, since the cleanup involves so many lines, I recommend to checkout a clean copy of the module from git to avoid merging conflicts.
Comment #24
hongpong commentedThis is great! It seems pretty much ready to go for a module application, it's certainly a lot more sophisticated than a lot of approved modules.
I don't think I formed those @see directives correctly - there is some other way they're supposed to be written that eludes me. Also the patches helps explain the serializer and entity in offers-wants to me - makes a fair bit more sense.
I copied the master branch to a new 7.x-1.x and pushed that to sandbox. It is supposed to be set up that way on official modules as the main branch (at least until D8).
Perhaps start writing up the module application here or on email & i might be able to help on that. So nifty!
Comment #25
esteve.badia commentedThere is still a lot of code cleanup to do. Now coder passes but there is pareview there with more hints:
http://ventral.org/pareview/httpgitdrupalorgsandboxesteve1367140git-7x-1x
Come on!
Comment #37
edumag commentedComment #39
edumag commentedComment #40
edumag commentedCode perfect review.
All files pass the standardized test.
It has also been grouped modules from doxygen, improving development documentation.
Comment #41
esteve.badia commentedThanks edumag for the fixes! But it seems that there are more issues to be solved before we close the issue:
Following: http://pareview.sh/pareview/httpgitdrupalorgsandboxesteve1367140git
So I reopen the issue.
With such a huge output it may be possible that we are missing something. You can re-run the review from the main page http://pareview.sh/ once the changes are pushed to the 7.x-1.x branch.
Once the pareview has a more attractive output, we should update our issue https://drupal.org/node/2267557 at the Drupal.org Project applications queue.
Comment #42
edumag commentedI have found that if you ask pareview analyze all ices fails to function names, but if you analyze a module no.
I guess waiting ices_ces_bank_function() and not ces_bank_function().
Comment #43
xavip commentedHi,
Problem about this is that jqPlot works with a core library and several separate plugins. Now ces_statistics is using this files:
jquery.jqplot.min.js
jqplot.dateAxisRenderer.min.js
jqplot.barRenderer.min.js
jqplot.canvasTextRenderer.min.js
jqplot.canvasAxisLabelRenderer.min.js
jqplot.canvasAxisTickRenderer.min.js
jqplot.categoryAxisRenderer.min.js
jqplot.pointLabels.min.js
jqplot.pieRenderer.min.js
Maybe we can reduce some of them, simplifing the graphics the module renders, but the installing procedure with library API will be a little bit complex. Do you know how can we simplify the installation?
Comment #44
edumag commentedNow I'm looking to use the libraries module to fix it.
Wait for it to finish before doing anything.
Comment #45
esteve.badia commented(1) I think the ces_xxx name warnings from pareview are just false positives, so I wouldn't worry about that.
(2) Regarding the jqplot issue, I think the most easy installation process is to downolad the whole jqplot library, and not only the needed files. We could document it with the following command:
Then we have to access the needed files from our code at libraries/jqplot/src/xxx
Comment #46
edumag commentedOK, i got
Comment #47
edumag commentedWere corrected almost all errors.
And added on branch 7.x-1.x
Comment #48
edumag commented