One day I will find out why developers hate documentation so much , or at least why they think features and code is more important than its documentation.
In the mean time, personally I wont give feedback to something that I have to waste my time reading code because spending 10 seconds per class is a second or third priority for you. No examples are not enough, actually I take class comments over examples any day. Wish you good luck in your effort and thank you for trying to make Pharo better , I may be annoyed with the Pharo documentation problem, but that does not mean I dont appreciate the efforts to improve Pharo. On Tue, Jun 21, 2016 at 11:11 AM Tudor Girba <[email protected]> wrote: > Hi Clement, > > Thanks for looking at it. > > Indeed, there aren’t many comments. A large part of the engine got > rewritten twice over the last months, and many of the previous comments > were no longer up to date. > > And no, the policy is not to not write comments :), but right now the > priority is on building examples. which you will find in the > Bloc-Core-Examples classes and their subclasses. > > Cheers, > Doru > > > > > On Jun 21, 2016, at 9:39 AM, Clément Bera <[email protected]> > wrote: > > > > Hi Doru, > > > > I downloaded the image, opened Nautilus, clicked on the package named > 'Bloc-Core' and all the classes I can see have no class comments (See > screenshot below). Is there a 'No class comment' policy in Bloc ? Or maybe > the top classes shown are just non representative of the class comments of > the overall framework. > > > > <Screen Shot 2016-06-21 at 9.33.31 AM.png> > > > > On Tue, Jun 21, 2016 at 7:42 AM, Tudor Girba <[email protected]> > wrote: > > Hi, > > > > Here is a brief update on the status of Bloc. > > > > Several of us came together to form a team and work to see Bloc in Pharo > 6 at least as a preview. The team communication happens via Slack in a > dedicated team, and the goal is to have regular progress/feedback > communication on this mailing list. > > > > Just because we have a dedicated team does not mean that your feedback > is important. In fact, over the last months, Bloc was redesigned again to > include the feedback we got here. So, now we have: > > - Element is responsible for drawing (no more shape) > > - Interaction area and clipping area are now distinct > > > > You can find the current build on top of Pharo 6 here: > > > https://ci.inria.fr/moose/job/bloc/PHARO=alpha,VERSION=development,VM=vmLatest/ > > > > The current team focus goes like this: > > - Alain is looking at events, > > - Glenn is playing with creating new elements in Bloc and refactoring > the way we can manage , > > - Alex (Syrel) and Esteban are working on the backend to make rendering > faster, > > - Doru is pretending to do something useful. > > > > Cheers, > > Doru > > > > > > -- > > www.tudorgirba.com > > www.feenk.com > > > > "What we can governs what we wish." > > > > > > > > > > > > > > -- > www.tudorgirba.com > www.feenk.com > > "Presenting is storytelling." > > >
