Smalltalk › Frameworks & Tools › Seaside › Seaside General

Generating HTML documentation on seaside.st

_‹ Previous Topic Next Topic _›

Classic

List

Threaded

5 messages Options

William Harford

Generating HTML documentation on seaside.st

The Generating HTML documentation badly needs updating. I am willing do it as soon as I can (sometime this week) and would like to know what is the best way I could go about doing so.

At Smalltalk solutions at least 3 people commented that the Generating HTML documentation on the website was a major obstacle to them getting started with Seaside. It was difficult to tell them "sorry no one was gotten around to fixing it yet". So if it is alright with everyone I would like to fix it.

Thanks

Will

___________________________________

Do I dream of electric sheep?

_______________________________________________
Seaside mailing list
[hidden email]
http://lists.squeakfoundation.org/cgi-bin/mailman/listinfo/seaside

Adrian Lienhard

Re: Generating HTML documentation on seaside.st

Indeed, this documentation is obsolete...
I suggest you mail the changes to Lukas and me. We will then update
the web page.

Thanks very much!
Adrian

On May 3, 2007, at 16:12 , William Harford wrote:

> The Generating HTML documentation badly needs updating. I am
> willing do it as soon as I can (sometime this week) and would like
> to know what is the best way I could go about doing so.
>
> At Smalltalk solutions at least 3 people commented that the
> Generating HTML documentation on the website was a major obstacle
> to them getting started with Seaside. It was difficult to tell them
> "sorry no one was gotten around to fixing it yet". So if it is
> alright with everyone I would like to fix it.
>
> Thanks
> Will
> ___________________________________
> Do I dream of electric sheep?
>
>
> _______________________________________________
> Seaside mailing list
> [hidden email]
> http://lists.squeakfoundation.org/cgi-bin/mailman/listinfo/seaside

_______________________________________________
Seaside mailing list
[hidden email]
http://lists.squeakfoundation.org/cgi-bin/mailman/listinfo/seaside

William Harford

Re: Generating HTML documentation on seaside.st

In reply to this post by William Harford

Ok I updated the documentation on the seaside.st website that deals with the old render stuff to use the new canvas. I would like everyone who is willing to to check it for any stupid errors I might of made.

I took the quickest route possible for modernizing the documentation. I used the existing documentation at a template for the updated documentation. While the updated documentation is factually accurate I don't think it represents the elegance and simplicity of Canvas accurately. Please post any sugestions or thoughts you might have on how the documentation could be written or constructed to better reflect how canvas works. I think it is important in the seaside documentation to assume your reader has only a minimal knowledge of Smalltalk. So we might be better off explaining things like cascades to the reader.

Comments or suggestions?

Thanks

Will

On May 3, 2007, at 10:12 AM, William Harford wrote:

The Generating HTML documentation badly needs updating. I am willing do it as soon as I can (sometime this week) and would like to know what is the best way I could go about doing so.

At Smalltalk solutions at least 3 people commented that the Generating HTML documentation on the website was a major obstacle to them getting started with Seaside. It was difficult to tell them "sorry no one was gotten around to fixing it yet". So if it is alright with everyone I would like to fix it.

Thanks
Will

_______________________________________________
Seaside mailing list
[hidden email]
http://lists.squeakfoundation.org/cgi-bin/mailman/listinfo/seaside

___________________________________

Do I dream of electric sheep?

_______________________________________________
Seaside mailing list
[hidden email]
http://lists.squeakfoundation.org/cgi-bin/mailman/listinfo/seaside

Ramiro Diaz Trepat

Re: Generating HTML documentation on seaside.st

In reply to this post by William Harford

Hello William,
On http://seaside.st/Documentation/GeneratingHTML

The first shown method reads:

renderContentOn: html
html heading level1; with: 'Hello World!'.

I believe there is a colon missing between level and 1.

On 5/3/07, William Harford <[hidden email]> wrote:

> The Generating HTML documentation badly needs updating. I am willing do it
> as soon as I can (sometime this week) and would like to know what is the
> best way I could go about doing so.
>
> At Smalltalk solutions at least 3 people commented that the Generating HTML
> documentation on the website was a major obstacle to them getting started
> with Seaside. It was difficult to tell them "sorry no one was gotten around
> to fixing it yet". So if it is alright with everyone I would like to fix it.
>
> Thanks
> Will
>
>
> ___________________________________
> Do I dream of electric sheep?
>
>
> _______________________________________________
> Seaside mailing list
> [hidden email]
> http://lists.squeakfoundation.org/cgi-bin/mailman/listinfo/seaside
>
>

_______________________________________________
Seaside mailing list
[hidden email]
http://lists.squeakfoundation.org/cgi-bin/mailman/listinfo/seaside

Patrick Collison

Re: Generating HTML documentation on seaside.st

Nope, level1 is there as a convenience method.

On 04/05/07, Ramiro Diaz Trepat <[hidden email]> wrote:

> Hello William,
> On http://seaside.st/Documentation/GeneratingHTML
>
> The first shown method reads:
>
> renderContentOn: html
> html heading level1; with: 'Hello World!'.
>
> I believe there is a colon missing between level and 1.
>
>
>
>
> On 5/3/07, William Harford <[hidden email]> wrote:
> > The Generating HTML documentation badly needs updating. I am willing do it
> > as soon as I can (sometime this week) and would like to know what is the
> > best way I could go about doing so.
> >
> > At Smalltalk solutions at least 3 people commented that the Generating HTML
> > documentation on the website was a major obstacle to them getting started
> > with Seaside. It was difficult to tell them "sorry no one was gotten around
> > to fixing it yet". So if it is alright with everyone I would like to fix it.
> >
> > Thanks
> > Will
> >
> >
> > ___________________________________
> > Do I dream of electric sheep?
> >
> >
>
> > _______________________________________________
> > Seaside mailing list
> > [hidden email]
> > http://lists.squeakfoundation.org/cgi-bin/mailman/listinfo/seaside
> >
> >
> _______________________________________________
> Seaside mailing list
> [hidden email]
> http://lists.squeakfoundation.org/cgi-bin/mailman/listinfo/seaside
>

_______________________________________________
Seaside mailing list
[hidden email]
http://lists.squeakfoundation.org/cgi-bin/mailman/listinfo/seaside