Please review the updated archgenxml2 manual

6 messages Options
Embed this post
Permalink
Vincent Fretin () Please review the updated archgenxml2 manual
Reply Threaded More More options
Print post
Permalink
Hi,

I rewrote or updated parts 2, 3 and 5 of the Getting Started section
of the archgenxml2 manual:
http://plone.org/documentation/manual/archgenxml2/startup/

Please review it and reply to this thread for any mistakes you found
in these pages.
All the comments on those pages will be removed soon.
Please not use the comments as a forum. It seems only Jens is alerted
when there is new comments on those pages.
Please use the archetypes-users mailing-list for installation problems
and plone-docs mailing-list if you want to contribute to the
documentation.

Cheers
--
Vincent Fretin

------------------------------------------------------------------------------
The NEW KODAK i700 Series Scanners deliver under ANY circumstances! Your
production scanning environment may not be a perfect world - but thanks to
Kodak, there's a perfect scanner to get the job done! With the NEW KODAK i700
Series Scanner you'll get full speed at 300 dpi even with all image
processing features enabled. http://p.sf.net/sfu/kodak-com
_______________________________________________
Plone-docs mailing list
[hidden email]
https://lists.sourceforge.net/lists/listinfo/plone-docs
Israel Saeta Pérez () Re: Please review the updated archgenxml2 manual
Reply Threaded More More options
Print post
Permalink
On Fri, May 8, 2009 at 4:26 PM, Vincent Fretin <[hidden email]> wrote:
Hi,

I rewrote or updated parts 2, 3 and 5 of the Getting Started section
of the archgenxml2 manual:
http://plone.org/documentation/manual/archgenxml2/startup/

Please review it and reply to this thread for any mistakes you found
in these pages.

Thanks Vincent!

I will try to review it this weekend.

-- israel


------------------------------------------------------------------------------
The NEW KODAK i700 Series Scanners deliver under ANY circumstances! Your
production scanning environment may not be a perfect world - but thanks to
Kodak, there's a perfect scanner to get the job done! With the NEW KODAK i700
Series Scanner you'll get full speed at 300 dpi even with all image
processing features enabled. http://p.sf.net/sfu/kodak-com
_______________________________________________
Plone-docs mailing list
[hidden email]
https://lists.sourceforge.net/lists/listinfo/plone-docs
Israel Saeta Pérez
Israel Saeta Pérez () Re: Please review the updated archgenxml2 manual
Reply Threaded More More options
Print post
Permalink
2009/5/9 Israel Saeta Pérez <[hidden email]>
Thanks Vincent!

I will try to review it this weekend.


Parts 2 and 3 are ok for me.

IMO, the "Hello World" section is a bit hard for newbies and would benefit from a little more explanation and steps specification.

As far as I've understood, the latest stable AGX version doesn't generate eggs but "old-style" zope2 products, right? Anyways, we should ask the user to drop the generated code in the "products" folder of her buildout, instead of into the "Products" folder of her instance, if we're reccommending buildout for AGX installation.

The screenshot in the "Hello World" page would better be presented in english and without the window border.

Thanks,
-- israel


------------------------------------------------------------------------------
The NEW KODAK i700 Series Scanners deliver under ANY circumstances! Your
production scanning environment may not be a perfect world - but thanks to
Kodak, there's a perfect scanner to get the job done! With the NEW KODAK i700
Series Scanner you'll get full speed at 300 dpi even with all image
processing features enabled. http://p.sf.net/sfu/kodak-com
_______________________________________________
Plone-docs mailing list
[hidden email]
https://lists.sourceforge.net/lists/listinfo/plone-docs
Israel Saeta Pérez
Vincent Fretin () Re: Please review the updated archgenxml2 manual
Reply Threaded More More options
Print post
Permalink
2009/5/10 Israel Saeta Pérez <[hidden email]>:
> 2009/5/9 Israel Saeta Pérez <[hidden email]>
>>
>> Thanks Vincent!
>>
>> I will try to review it this weekend.
>
> Parts 2 and 3 are ok for me.
good.

>
> IMO, the "Hello World" section is a bit hard for newbies and would benefit
> from a little more explanation and steps specification.
>
> As far as I've understood, the latest stable AGX version doesn't generate
> eggs but "old-style" zope2 products, right? Anyways, we should ask the user
> to drop the generated code in the "products" folder of her buildout, instead
> of into the "Products" folder of her instance, if we're reccommending
> buildout for AGX installation.

Yes, AGX generate old-style products.
What I do personally is create an egg skeleton with paster in the src
directory of the buildout:
paster create -t basic_namespace Products.FooBar
cd Products.FooBar
mkdir model
I put my FooBar.zargo model in the model directory, and when I want to
generate the code, I go to Products.FooBar/Products
and do:
archgenxml ../model/FooBar.zargo


>
> The screenshot in the "Hello World" page would better be presented in
> english and without the window border.
Yeah, we should take new screenshots with recent ArgoUML and in english.

I try to update the Hello World page then.
Thanks for reviewing.

Cheers
--
Vincent Fretin

------------------------------------------------------------------------------
The NEW KODAK i700 Series Scanners deliver under ANY circumstances! Your
production scanning environment may not be a perfect world - but thanks to
Kodak, there's a perfect scanner to get the job done! With the NEW KODAK i700
Series Scanner you'll get full speed at 300 dpi even with all image
processing features enabled. http://p.sf.net/sfu/kodak-com
_______________________________________________
Plone-docs mailing list
[hidden email]
https://lists.sourceforge.net/lists/listinfo/plone-docs
Israel Saeta Pérez () Re: Please review the updated archgenxml2 manual
Reply Threaded More More options
Print post
Permalink
2009/5/11 Vincent Fretin wrote
Israel Saeta wrote:
> IMO, the "Hello World" section is a bit hard for newbies and would benefit
> from a little more explanation and steps specification.
>
> As far as I've understood, the latest stable AGX version doesn't generate
> eggs but "old-style" zope2 products, right? Anyways, we should ask the user
> to drop the generated code in the "products" folder of her buildout, instead
> of into the "Products" folder of her instance, if we're reccommending
> buildout for AGX installation.

Yes, AGX generate old-style products.
What I do personally is create an egg skeleton with paster in the src
directory of the buildout:
paster create -t basic_namespace Products.FooBar
cd Products.FooBar
mkdir model
I put my FooBar.zargo model in the model directory, and when I want to
generate the code, I go to Products.FooBar/Products
and do:
archgenxml ../model/FooBar.zargo

Cool! Could you update the "hello world" page or any other where it fits better with these instructions to (manually) eggify the product generated by AGX?
 
-- israel


------------------------------------------------------------------------------
The NEW KODAK i700 Series Scanners deliver under ANY circumstances! Your
production scanning environment may not be a perfect world - but thanks to
Kodak, there's a perfect scanner to get the job done! With the NEW KODAK i700
Series Scanner you'll get full speed at 300 dpi even with all image
processing features enabled. http://p.sf.net/sfu/kodak-com
_______________________________________________
Plone-docs mailing list
[hidden email]
https://lists.sourceforge.net/lists/listinfo/plone-docs
Israel Saeta Pérez
Vincent Fretin () Re: Please review the updated archgenxml2 manual
Reply Threaded More More options
Print post
Permalink
2009/5/11 Israel Saeta Pérez <[hidden email]>:
> Cool! Could you update the "hello world" page or any other where it fits
> better with these instructions to (manually) eggify the product generated by
> AGX?
I'll do that.

I updated
http://plone.org/documentation/manual/archgenxml2/reference/tagged-values
http://plone.org/documentation/manual/archgenxml2/reference/stereotypes
But if I set the type to StructuredText, I get
"We’re sorry, but there is a temporary problem displaying this page
while we switch to the new site…"
or a blank page.
The markup is correct, I can copy and paste the content to one of my
Plone, it works perfectly.
So for now, I set it to the ugly plain/text. :-(
--
Vincent Fretin

------------------------------------------------------------------------------
The NEW KODAK i700 Series Scanners deliver under ANY circumstances! Your
production scanning environment may not be a perfect world - but thanks to
Kodak, there's a perfect scanner to get the job done! With the NEW KODAK i700
Series Scanner you'll get full speed at 300 dpi even with all image
processing features enabled. http://p.sf.net/sfu/kodak-com
_______________________________________________
Plone-docs mailing list
[hidden email]
https://lists.sourceforge.net/lists/listinfo/plone-docs