r3wp [groups: 83 posts: 189283]
  • Home
  • Script library
  • AltME Archive
  • Mailing list
  • Articles Index
  • Site search
 

World: r3wp

[!REBOL3-OLD1]

Henrik
21-Aug-2007
[4214x2]
but... on-get-value has nothing to do with "defaults"?
besides, I can see from your comments that the look-options system 
hasn't been documented yet.
Pekr
21-Aug-2007
[4216x2]
no? it just return default value you wish to defaultly return, no? 
:-) Sorry for english :-)
as for doc writers:
Henrik
21-Aug-2007
[4218]
no, it returns whatever value you want to return from within the 
face's spec block, when you invoke GET-FACE.
Pekr
21-Aug-2007
[4219x2]
Let's not depreciate my points, if possible. I know that I may be 
harsh, but - I was main collumnist for Amiga Review for 4 years. 
In my past job, my boss used me to write some things for management 
= nice reading, about nothing, but noone dared to say anything against 
it :-) I mean - docs should be kind of smooth reading. What I currently 
think about docs (I already mentioned the good ones) is - they should 
read smoothly. They should not be references, but they should talk 
concepts ....
Currently reading docs (and I know they are supposed to change) is 
like reading a facts ... there is function xy, which does that. But 
the question of novice is - but why?
Henrik
21-Aug-2007
[4221]
we are already internally talking about the shape of the documentation. 
right now, the important thing is that WE HAVE DOCS. that is opposed 
to some R2 docs that are NON-EXISTANT. fixing the flow to make it 
nicely readable comes later. this is just not a priority.
Pekr
21-Aug-2007
[4222x4]
Mostly when I think about presentations or some docs, I try to imagine, 
what might typical user need to understand the issue. And also - 
what I needed to know, to finally get it too. that is just my suggestion. 
And that is why I liked R2 View engine doc from August 2005. Awesome 
work. I hope we can adapt to it ....
I don't agree that R2 does not have docs ...
E.g. - let's look into some VID reference Introduction. Some may 
find it vague, and saying nothing:


By their nature, graphical user interfaces (GUI) are more descriptive 
than they are functional. In REBOL, the Visual Interface Dialect 
(VID) provides an efficient method of describing GUIs. VID is implemented 
as a layer that rides on top of the REBOL/View graphical compositing 
system. VID provides shortcut expressions that are automatically 
translated into View objects and functions. You can seamlessly combine 
VID and View code and data for great power and flexibility.


Whereas for me, it s real jewel, as it introduces me into concept 
of relation of View and VID.
btw - some might remember, that some 4 months ago, I asked to be 
involved in the docs grop at least or to talk the marketing strategy. 
I know that it might seem being preliminary, while it is not ....
Henrik
21-Aug-2007
[4226]
pekr, I think you are nitpicking way too much right now. We don't 
have the time to make pretty well-organized docs right now. Your 
input will be much more appropriate when R3 goes into beta, when 
docs are opened up and we have time to deal with this, OK?
Pekr
21-Aug-2007
[4227]
Henrik - for you I might be nitpicking, but from my pov, it is just 
you, who is missinterpreting meaning of my requests. And that is 
maybe the difference between good developer (you) and mostly IT manager 
(me). I follow different patterns ...
Henrik
21-Aug-2007
[4228]
you are requesting things that are completely low priority right 
now
Pekr
21-Aug-2007
[4229]
Maybe the whole situation is just caused because we are very few. 
With larger community even my aproach might work as some ppl might 
work on docs in parallel ...
Henrik
21-Aug-2007
[4230]
I think the whole situation is cause by you commenting on things 
that are not done. Perhaps it's a good idea to close the docs even 
further down now, so you can't see them anymore, so we'll at least 
have the piece and quiet required to finish them.
Pekr
21-Aug-2007
[4231]
Henrik - and I find you latest remark very arrogant.
Henrik
21-Aug-2007
[4232x2]
but that is not up to me
Pekr, I just want you to stop commenting on things that aren't done. 
Can't you see that?
Pekr
21-Aug-2007
[4234x2]
And I want Alpha group to be extended by Alpha+ group, which could 
work on other things which might be needed sooner or later. There 
is lots of work on other fronts too. You would have not to think 
about how to write docs if others would write the docs, can't you 
see it? But then you would have to stop playing elite ....
I am off from that for now ...
amacleod
21-Aug-2007
[4236]
I kind of see Henrik's point...How do you write docs for things that 
are not complete...ot just code but the actual conncepts of certain 
aspects do not seem to be naild down yet. How do write docs in this 
situation?
Rebolek
21-Aug-2007
[4237]
Pekr, just calm down, how can someone write full docs, when VID3 
is not yet finished? Can't you wait a bit more? Where's the problem? 
Don't base your assumptions on some unfinished docs, I know you're 
eager to get R3, but, please, wait until it's done.
amacleod
21-Aug-2007
[4238]
How does the coder convey to the docs writer what to write if he 
does not know waht the code is going to do?
Henrik
21-Aug-2007
[4239x2]
Pekr, we _will_ be getting back to these things you mention. it's 
just not the right time yet. There is plenty of progress, but still 
plenty to do in terms of code, where we can't just write docs out 
of thin air.
and Pekr: VID3 kicks ass. :-)
Rebolek
21-Aug-2007
[4241]
too bad the url is so easy to figure out, didn't you know it, you 
had nothing to complain about ;)
Pekr
21-Aug-2007
[4242x3]
amacleod - there aparently is more things that are complete - you 
saw the mention docs are some 30% behind? And have you ever been 
in process of writing docs? I mean - in the team? Do you think that 
ppl only wait for the work to be 100% finished? Some concepts HAVE 
to be already in place. I prefer to rewrite/restylize docs instead 
of writing them in a hurry ...
Rebolek - you are far from the truth - I don't want to get R3 just 
because of sake of having it ...
I am more interested in the marketing process  - now read that - 
http://www.rebol.com/help-wanted.html... do you think that process 
should not run in parallel?
Henrik
21-Aug-2007
[4245]
apply for the job then
Pekr
21-Aug-2007
[4246x2]
There is so many other things. But we need to input. In fact - I 
don't agree with www.rebol.com world release, unless RT finds time 
to discuss other things. Because - I want R3 to be successfull, so 
I would prefer to prepare on other fronts, as I said  ....
I will apply for the job from the other side - user.r . I want to 
help that thing organised. If you would ask btiffin, I think that 
he would understand my points. My main barrier is my english. I can 
be present on internet public forums, evangelising rebol, talk to 
ppl, explain, but I can't represent RT ...
Henrik
21-Aug-2007
[4248]
yes, please do. there will be a requirement for much more help, once 
R3 goes beta.
Pekr
21-Aug-2007
[4249x2]
and as for VID3 kicking ass - I hope so, as I like my little fights 
with Bobik between VID and PythonCard, so I really hope I have some 
new fresh blood in my veins for my new round of evening tea talks 
;-)
Henrik - I am already selected user.r community representative, well, 
even if only few ppl voted, the thing was kind of strange :-)
Henrik
21-Aug-2007
[4251]
indeed it kicks ass. a very small example:

view [progress slider attach]


slider is attached to progress and will adjust it's length automatically.
Pekr
21-Aug-2007
[4252]
ok, let's fight a bit :-)
Henrik
21-Aug-2007
[4253]
and you get automatic resizing thrown in for free
Pekr
21-Aug-2007
[4254]
I am a new programmer - how it connects? I want to have some imagination 
about it. btw - that was the most difficult part of VID vs View. 
At least when I taught Bobik VID. Once you needed to go deeper, non 
skilled View guru would get lost ...
amacleod
21-Aug-2007
[4255]
Sounds great
Pekr
21-Aug-2007
[4256]
Henrik - I saw some weird arithmetic expressions for attach. Just 
one question - does it allow named variables instead of integers?
Henrik
21-Aug-2007
[4257x2]
there's a lot more interconnection between words in VID now.
yes, it did that from the start, but the other thing is much easier, 
when you have many attachments to do.
Pekr
21-Aug-2007
[4259x2]
I remember romano paolo tenca's 'attach, but it was resizing related. 
Ach, it was 'anchor ....
What if you dynamically insert new element into layout? Will it reattach 
itself? :-)
Henrik
21-Aug-2007
[4261]
I'm not sure. I haven't tried it.
Gabriele
21-Aug-2007
[4262]
Petr, then you should not complain about VID, but about the docs. 
Problem is, we don't have anyone to write them. Brian is doing his 
best, but I don't expect him to be able to just do *everything* (user.r, 
testing, writing docs...)
Pekr
21-Aug-2007
[4263]
Maybe I could help with docs, but not sure if I would be able to 
understand new VID to that extent, to be able to write one ...