[ANN][Bloc] February report

Previous Topic Next Topic
 
classic Classic list List threaded Threaded
9 messages Options
Reply | Threaded
Open this post in threaded view
|

[ANN][Bloc] February report

Aliaksei Syrel
Hi all

Today is sunday meaning that we should make a monthly report on what happened in Bloc in February.

 - BlLinearLayout (stack layout + proportional layout)
  • Uses gtExample for examples and tests: BlLinearLayoutExamples
  • Has extensive class docs and method docs. Still some methods are missing docs.
  • Has "book" chapter (more info below)
- Integration with OS-Window
- Unified shape scaling behaviour.
  • By default shape scales to fill BlElement's extent.
  • Supports different resizing strategies.
  • Started "book" chapter
- Added documentation to various parts of Bloc
  • Still there are a lot of places not covered with docs.
  • Also we auto-generate "book" chapters from bloc example classes. In attachment you can find linear-layout and not finished shape chapter.

Future

- Bloc presentation on PharoDays2016
  • 01 April 2016
  • 11:05–11:25 Bloc: Towards a vector-based GUI
- Working on
  • Grid layout (all rules above apply, docs + tests + chapter)
  • Bloc tests
  • Documentation

Cheers,
Alex


bloc-documentation.zip (250K) Download Attachment
Reply | Threaded
Open this post in threaded view
|

Re: [ANN][Bloc] February report

kilon.alios
I heard that you made several braking backward compatibility changes to Bloc, is there a timeline or roadmap when the specification of the API will stabilize so we can use it without the fear of our GUIs stop working because Bloc brakes backward compatibility ?

On Sun, Mar 6, 2016 at 1:36 PM Aliaksei Syrel <[hidden email]> wrote:
Hi all

Today is sunday meaning that we should make a monthly report on what happened in Bloc in February.

 - BlLinearLayout (stack layout + proportional layout)
  • Uses gtExample for examples and tests: BlLinearLayoutExamples
  • Has extensive class docs and method docs. Still some methods are missing docs.
  • Has "book" chapter (more info below)
- Integration with OS-Window
- Unified shape scaling behaviour.
  • By default shape scales to fill BlElement's extent.
  • Supports different resizing strategies.
  • Started "book" chapter
- Added documentation to various parts of Bloc
  • Still there are a lot of places not covered with docs.
  • Also we auto-generate "book" chapters from bloc example classes. In attachment you can find linear-layout and not finished shape chapter.

Future

- Bloc presentation on PharoDays2016
  • 01 April 2016
  • 11:05–11:25 Bloc: Towards a vector-based GUI
- Working on
  • Grid layout (all rules above apply, docs + tests + chapter)
  • Bloc tests
  • Documentation

Cheers,
Alex

Reply | Threaded
Open this post in threaded view
|

Re: [ANN][Bloc] February report

Tudor Girba-2
Hi,

The goal is to get to an alpha state until PharoDays.

Cheers,
Doru


> On Mar 6, 2016, at 1:11 PM, Dimitris Chloupis <[hidden email]> wrote:
>
> I heard that you made several braking backward compatibility changes to Bloc, is there a timeline or roadmap when the specification of the API will stabilize so we can use it without the fear of our GUIs stop working because Bloc brakes backward compatibility ?
>
> On Sun, Mar 6, 2016 at 1:36 PM Aliaksei Syrel <[hidden email]> wrote:
> Hi all
>
> Today is sunday meaning that we should make a monthly report on what happened in Bloc in February.
>
>  - BlLinearLayout (stack layout + proportional layout)
> • Uses gtExample for examples and tests: BlLinearLayoutExamples
> • Has extensive class docs and method docs. Still some methods are missing docs.
> • Has "book" chapter (more info below)
> - Integration with OS-Window
> • Finally works, really fast.
> • Events do not work as expected because of https://pharo.fogbugz.com/f/cases/17757
> - Unified shape scaling behaviour.
> • By default shape scales to fill BlElement's extent.
> • Supports different resizing strategies.
> • Started "book" chapter
> - Added documentation to various parts of Bloc
> • Still there are a lot of places not covered with docs.
> • Also we auto-generate "book" chapters from bloc example classes. In attachment you can find linear-layout and not finished shape chapter.
>
> Future
>
> - Bloc presentation on PharoDays2016
> • 01 April 2016
> • 11:05–11:25 Bloc: Towards a vector-based GUI
> - Working on
> • Grid layout (all rules above apply, docs + tests + chapter)
> • Bloc tests
> • Documentation
>
> Cheers,
> Alex
>

--
www.tudorgirba.com
www.feenk.com

"To utilize feedback, you first have to acquire it."


Reply | Threaded
Open this post in threaded view
|

Re: [ANN][Bloc] February report

kilon.alios
Thanks Doru :)

On Sun, Mar 6, 2016 at 2:14 PM Tudor Girba <[hidden email]> wrote:
Hi,

The goal is to get to an alpha state until PharoDays.

Cheers,
Doru


> On Mar 6, 2016, at 1:11 PM, Dimitris Chloupis <[hidden email]> wrote:
>
> I heard that you made several braking backward compatibility changes to Bloc, is there a timeline or roadmap when the specification of the API will stabilize so we can use it without the fear of our GUIs stop working because Bloc brakes backward compatibility ?
>
> On Sun, Mar 6, 2016 at 1:36 PM Aliaksei Syrel <[hidden email]> wrote:
> Hi all
>
> Today is sunday meaning that we should make a monthly report on what happened in Bloc in February.
>
>  - BlLinearLayout (stack layout + proportional layout)
>       • Uses gtExample for examples and tests: BlLinearLayoutExamples
>       • Has extensive class docs and method docs. Still some methods are missing docs.
>       • Has "book" chapter (more info below)
> - Integration with OS-Window
>       • Finally works, really fast.
>       • Events do not work as expected because of https://pharo.fogbugz.com/f/cases/17757
> - Unified shape scaling behaviour.
>       • By default shape scales to fill BlElement's extent.
>       • Supports different resizing strategies.
>       • Started "book" chapter
> - Added documentation to various parts of Bloc
>       • Still there are a lot of places not covered with docs.
>       • Also we auto-generate "book" chapters from bloc example classes. In attachment you can find linear-layout and not finished shape chapter.
>
> Future
>
> - Bloc presentation on PharoDays2016
>       • 01 April 2016
>       • 11:05–11:25 Bloc: Towards a vector-based GUI
> - Working on
>       • Grid layout (all rules above apply, docs + tests + chapter)
>       • Bloc tests
>       • Documentation
>
> Cheers,
> Alex
>

--
www.tudorgirba.com
www.feenk.com

"To utilize feedback, you first have to acquire it."


Reply | Threaded
Open this post in threaded view
|

Re: [ANN][Bloc] February report

stepharo
In reply to this post by Aliaksei Syrel
***Thanks*** for this report!

Stef


Le 6/3/16 12:34, Aliaksei Syrel a écrit :
Hi all

Today is sunday meaning that we should make a monthly report on what happened in Bloc in February.

 - BlLinearLayout (stack layout + proportional layout)
  • Uses gtExample for examples and tests: BlLinearLayoutExamples
  • Has extensive class docs and method docs. Still some methods are missing docs.
  • Has "book" chapter (more info below)
- Integration with OS-Window
- Unified shape scaling behaviour.
  • By default shape scales to fill BlElement's extent.
  • Supports different resizing strategies.
  • Started "book" chapter
- Added documentation to various parts of Bloc
  • Still there are a lot of places not covered with docs.
  • Also we auto-generate "book" chapters from bloc example classes. In attachment you can find linear-layout and not finished shape chapter.

Future

- Bloc presentation on PharoDays2016
  • 01 April 2016
  • 11:05–11:25 Bloc: Towards a vector-based GUI
- Working on
  • Grid layout (all rules above apply, docs + tests + chapter)
  • Bloc tests
  • Documentation

Cheers,
Alex


Reply | Threaded
Open this post in threaded view
|

Re: [ANN][Bloc] February report

stepharo
In reply to this post by Aliaksei Syrel
Hi Alex

How can I "compile" the doc and read it?
Clement in his tutorial on VM use pillar and download an image and extract from the image the examples
so may be we could do the same.
Should I run the examples when I do a change to make sure that I'm not breaking something.
How do you get green tests?

Stef


Le 6/3/16 12:34, Aliaksei Syrel a écrit :
Hi all

Today is sunday meaning that we should make a monthly report on what happened in Bloc in February.

 - BlLinearLayout (stack layout + proportional layout)
  • Uses gtExample for examples and tests: BlLinearLayoutExamples
  • Has extensive class docs and method docs. Still some methods are missing docs.
  • Has "book" chapter (more info below)
- Integration with OS-Window
- Unified shape scaling behaviour.
  • By default shape scales to fill BlElement's extent.
  • Supports different resizing strategies.
  • Started "book" chapter
- Added documentation to various parts of Bloc
  • Still there are a lot of places not covered with docs.
  • Also we auto-generate "book" chapters from bloc example classes. In attachment you can find linear-layout and not finished shape chapter.

Future

- Bloc presentation on PharoDays2016
  • 01 April 2016
  • 11:05–11:25 Bloc: Towards a vector-based GUI
- Working on
  • Grid layout (all rules above apply, docs + tests + chapter)
  • Bloc tests
  • Documentation

Cheers,
Alex


Reply | Threaded
Open this post in threaded view
|

Re: [ANN][Bloc] February report

Tudor Girba-2
Hi,

The readable htmls are already pre-built in the zip file:
./build/layouts/linear/linear.html
./build/shape/path/shape.html

These files are produced out of source code that is based on a little engine for describing such step-by-step tutorials. But, the details of this engine are still being worked on.

Cheers,
Doru


> On Mar 6, 2016, at 2:43 PM, stepharo <[hidden email]> wrote:
>
> Hi Alex
>
> How can I "compile" the doc and read it?
> Clement in his tutorial on VM use pillar and download an image and extract from the image the examples
> so may be we could do the same.
> Should I run the examples when I do a change to make sure that I'm not breaking something.
> How do you get green tests?
>
> Stef
>
>
> Le 6/3/16 12:34, Aliaksei Syrel a écrit :
>> Hi all
>>
>> Today is sunday meaning that we should make a monthly report on what happened in Bloc in February.
>>
>>  - BlLinearLayout (stack layout + proportional layout)
>> • Uses gtExample for examples and tests: BlLinearLayoutExamples
>> • Has extensive class docs and method docs. Still some methods are missing docs.
>> • Has "book" chapter (more info below)
>> - Integration with OS-Window
>> • Finally works, really fast.
>> • Events do not work as expected because of https://pharo.fogbugz.com/f/cases/17757
>> - Unified shape scaling behaviour.
>> • By default shape scales to fill BlElement's extent.
>> • Supports different resizing strategies.
>> • Started "book" chapter
>> - Added documentation to various parts of Bloc
>> • Still there are a lot of places not covered with docs.
>> • Also we auto-generate "book" chapters from bloc example classes. In attachment you can find linear-layout and not finished shape chapter.
>>
>> Future
>>
>> - Bloc presentation on PharoDays2016
>> • 01 April 2016
>> • 11:05–11:25 Bloc: Towards a vector-based GUI
>> - Working on
>> • Grid layout (all rules above apply, docs + tests + chapter)
>> • Bloc tests
>> • Documentation
>>
>> Cheers,
>> Alex
>>
>

--
www.tudorgirba.com
www.feenk.com

"Don't give to get. Just give."







Reply | Threaded
Open this post in threaded view
|

Re: [ANN][Bloc] February report

stepharo
Nice!
Since the development of pillar will restart at the end of the month it
would be good to make sure that the new version
does not break this output. So it would be good to have a job that
generates and publish the doc on the web
We could have it under http://books.pharo.org

I did a new version with Alpha Books and Bloc documentation could go
there if you want.
Now it may be too early.

Stef

Le 6/3/16 14:53, Tudor Girba a écrit :

> Hi,
>
> The readable htmls are already pre-built in the zip file:
> ./build/layouts/linear/linear.html
> ./build/shape/path/shape.html
>
> These files are produced out of source code that is based on a little engine for describing such step-by-step tutorials. But, the details of this engine are still being worked on.
>
> Cheers,
> Doru
>
>
>> On Mar 6, 2016, at 2:43 PM, stepharo <[hidden email]> wrote:
>>
>> Hi Alex
>>
>> How can I "compile" the doc and read it?
>> Clement in his tutorial on VM use pillar and download an image and extract from the image the examples
>> so may be we could do the same.
>> Should I run the examples when I do a change to make sure that I'm not breaking something.
>> How do you get green tests?
>>
>> Stef
>>
>>
>> Le 6/3/16 12:34, Aliaksei Syrel a écrit :
>>> Hi all
>>>
>>> Today is sunday meaning that we should make a monthly report on what happened in Bloc in February.
>>>
>>>   - BlLinearLayout (stack layout + proportional layout)
>>> • Uses gtExample for examples and tests: BlLinearLayoutExamples
>>> • Has extensive class docs and method docs. Still some methods are missing docs.
>>> • Has "book" chapter (more info below)
>>> - Integration with OS-Window
>>> • Finally works, really fast.
>>> • Events do not work as expected because of https://pharo.fogbugz.com/f/cases/17757
>>> - Unified shape scaling behaviour.
>>> • By default shape scales to fill BlElement's extent.
>>> • Supports different resizing strategies.
>>> • Started "book" chapter
>>> - Added documentation to various parts of Bloc
>>> • Still there are a lot of places not covered with docs.
>>> • Also we auto-generate "book" chapters from bloc example classes. In attachment you can find linear-layout and not finished shape chapter.
>>>
>>> Future
>>>
>>> - Bloc presentation on PharoDays2016
>>> • 01 April 2016
>>> • 11:05–11:25 Bloc: Towards a vector-based GUI
>>> - Working on
>>> • Grid layout (all rules above apply, docs + tests + chapter)
>>> • Bloc tests
>>> • Documentation
>>>
>>> Cheers,
>>> Alex
>>>
> --
> www.tudorgirba.com
> www.feenk.com
>
> "Don't give to get. Just give."
>
>
>
>
>
>
>
>


Reply | Threaded
Open this post in threaded view
|

Re: [ANN][Bloc] February report

abergel
In reply to this post by Aliaksei Syrel
Hi Alex,

This is a fantastic report. Unfortunately, I will not be at Pharo’s days.
We will have a very close look at it as Bloc will be the base of Roassal3.

Cheers,
Alexandre


> On Mar 6, 2016, at 8:34 AM, Aliaksei Syrel <[hidden email]> wrote:
>
> Hi all
>
> Today is sunday meaning that we should make a monthly report on what happened in Bloc in February.
>
>  - BlLinearLayout (stack layout + proportional layout)
> • Uses gtExample for examples and tests: BlLinearLayoutExamples
> • Has extensive class docs and method docs. Still some methods are missing docs.
> • Has "book" chapter (more info below)
> - Integration with OS-Window
> • Finally works, really fast.
> • Events do not work as expected because of https://pharo.fogbugz.com/f/cases/17757
> - Unified shape scaling behaviour.
> • By default shape scales to fill BlElement's extent.
> • Supports different resizing strategies.
> • Started "book" chapter
> - Added documentation to various parts of Bloc
> • Still there are a lot of places not covered with docs.
> • Also we auto-generate "book" chapters from bloc example classes. In attachment you can find linear-layout and not finished shape chapter.
>
> Future
>
> - Bloc presentation on PharoDays2016
> • 01 April 2016
> • 11:05–11:25 Bloc: Towards a vector-based GUI
> - Working on
> • Grid layout (all rules above apply, docs + tests + chapter)
> • Bloc tests
> • Documentation
>
> Cheers,
> Alex
>
> <bloc-documentation.zip>

--
_,.;:~^~:;._,.;:~^~:;._,.;:~^~:;._,.;:~^~:;._,.;:
Alexandre Bergel  http://www.bergel.eu
^~:;._,.;:~^~:;._,.;:~^~:;._,.;:~^~:;._,.;:~^~:;.