âYou know the guy doing the video remove it because it was in rage against us.â That is a real shame - particularly given that the conversation here has been quite constructive in how to improve the situation. Anyway - its a good video, and we can alway record another one if heâs dead against us using it. For now, weâll link to it and say thank you. Tim On 7 Aug 2014, at 14:47, stepharo <stepharo@free.fr> wrote:
Okay, so thatâs good, but you guys really need to improve the documentation on the mechanical walkthrough of how to actually claim and submit a bug fix.
Today, I happened to have some spare time, so I figured, what the hell, why not see if I canât fix some bugs blocking the Pharo 4 release. Itâs a reach, granted, but I used to be good at Smalltalk, Iâm still a good programmer, and I figure at least one of the blockers is in the really-annoying-but-technically-easy bucket that no one was willing to touch yet, so chances are good.
Armed with my old knowledge of how Squeak contrib used to work, I at least got as far as manually downloading a VM, manually downloading a .changes/.image, and manually downloading a .sources. Then I go to pharo.org andâ¦
Well, hmm. No instructions on the submission or development process? Well, no matter, I know you guys use FogBugz, so maybe on the FogBugz wiki? The landing page is unhelpful; clicking on the word âhereâ at âReporting or Fixing a Bug?â takes me to http://pharo.org/get-involved which is a 404. Heading back, I try âDocumentationâ, which contains a lot of documentation, but none how to submit fixes. You know the guy doing the video remove it because it was in rage against us. We were not aware that it was linked them.
Likewise, I can get great info on the workflow of a bug, but not on how to move code through that workflow.
At this point, by luck, I realize that thereâs a link to âContributeâ in the TOC in FogBugz. Brilliant, exactly what I want! And it has a video walkthrough, no less, which takes me to http://vimeo.com/75183993 andâ¦nope, thatâs a 404 again. Thankfully, the link below it appears to let me download a nice MP4, which does walk me throughâ¦submitting a slice. I actually have no idea if this is the right way to do things anymore, but given that you guys seem to have a super-active GitHub repo, I kind of doubt it. And while thereâs some documentation scattered around about how to use Git and Pharo, itâs not centralized or obvious.
Itâs up to the community to be involved with the tools they love and to submit patches, and youâre totally right to remind everyone that itâs up to us to improve Pharo if we want to keep it alive, but itâs up to the core team to make sure that itâs easy for us to do so, and I think that Pharoâs not doing terribly well on that front right now.
We add a description on the old web site but he got lost. Now in a nutshell, to submit a fix
- donwload latest image (there is a script on download) - do a fix for a giving bug - publish a slice press (+ slice) in MC, add the dirty packages - publish it in the inbox (click on inbox and press save) - take a fresh image. - reload it and check that it fixes the problem (open MC and click on inbox + open).
Does it help? Was it so complex?
âBenjamin