You are viewing a plain text version of this content. The canonical link for it is here.
Posted to dev@velocity.apache.org by Will Glass-Husain <wg...@forio.com> on 2005/07/10 11:23:40 UTC
redesign of web site - comments please
Hi,
I've been tinkering with a site redesign for months - I finally got a little more oomph and finished a first cut. It's at
http://jakarta.apache.org/velocity/temp/
This is both a content and site redesign. The primary goal was to make the web site more accessible to novice users, to remove outdated content, and to clean it up a little.
Specifically, I redid the home page, reorganized the TOC, moved all community content to the Wiki, and added a couple of new articles. Product documentation is now 1.4 only. The site format looks the same but has a new logo and is CSS based. Consequently it now prints cleanly with no menu bar. (Thanks, Tim for the logo and the CSS push!)
At this point, I could use a little help. First of all - anyone want to volunteer to copyedit (nitpick, please) the new content? That's
* Home page
* Overview
* Getting Started
* Web Applications
and in the Wiki (just go and and edit)
* DocumentationGuidelines
Obviously for some of these I cribbed from the Wiki and various earlier web files - thanks to all original authors.
Second, I'd appreciate any general comments and fixes. I'm a bit of a CSS positioning novice - suggestions on layout are welcome.
One worry I have is links to the user's guide. I've moved it to the "docs14" folder (to allow for multiple versions). I'm going to set up a redirect for all original links to send them to the new file. Hopefully this will work.
If the site gets a general thumbs up I'll check it in to source control and then (after a comment period) update the web site.
Best, WILL
_______________________________________
Forio Business Simulations
Will Glass-Husain
wglass@forio.com
www.forio.com
Re: redesign of web site - comments please
Posted by Claude Brisson <cl...@renegat.net>.
very ergonomic
the faq~wiki is excellent
--
Claude
On Sun, 2005-07-10 at 02:23 -0700, Will Glass-Husain wrote:
> Hi,
>
> I've been tinkering with a site redesign for months - I finally got a little more oomph and finished a first cut. It's at
> http://jakarta.apache.org/velocity/temp/
>
> This is both a content and site redesign. The primary goal was to make the web site more accessible to novice users, to remove outdated content, and to clean it up a little.
>
> Specifically, I redid the home page, reorganized the TOC, moved all community content to the Wiki, and added a couple of new articles. Product documentation is now 1.4 only. The site format looks the same but has a new logo and is CSS based. Consequently it now prints cleanly with no menu bar. (Thanks, Tim for the logo and the CSS push!)
>
> At this point, I could use a little help. First of all - anyone want to volunteer to copyedit (nitpick, please) the new content? That's
> * Home page
> * Overview
> * Getting Started
> * Web Applications
>
> and in the Wiki (just go and and edit)
> * DocumentationGuidelines
>
> Obviously for some of these I cribbed from the Wiki and various earlier web files - thanks to all original authors.
>
> Second, I'd appreciate any general comments and fixes. I'm a bit of a CSS positioning novice - suggestions on layout are welcome.
>
> One worry I have is links to the user's guide. I've moved it to the "docs14" folder (to allow for multiple versions). I'm going to set up a redirect for all original links to send them to the new file. Hopefully this will work.
>
> If the site gets a general thumbs up I'll check it in to source control and then (after a comment period) update the web site.
>
> Best, WILL
>
> _______________________________________
> Forio Business Simulations
>
> Will Glass-Husain
> wglass@forio.com
> www.forio.com
--
---------------------------------------------------------------------
To unsubscribe, e-mail: velocity-dev-unsubscribe@jakarta.apache.org
For additional commands, e-mail: velocity-dev-help@jakarta.apache.org
Re: redesign of web site - comments please
Posted by Will Glass-Husain <wg...@forio.com>.
Thanks for the comments!
The text is limited to 650 pixels, and then whitespace on the right. I
thought making the text have a fixed width looked better than letting it
wrap all the way across.
WILL
----- Original Message -----
From: "Jason R Briggs" <ja...@gmail.com>
To: "Velocity Developers List" <ve...@jakarta.apache.org>
Sent: Sunday, July 10, 2005 5:09 AM
Subject: Re: redesign of web site - comments please
> Hi Will
>
> There's a large column of whitespace on the right-hand side of my screen
> (linux+firefox) -- just wanted to check it was intentional?
>
> Here's some nitpick copy-editing for you:
>
> 1. Second paragraph on the homepage:
>
> /Velocity separates Java code from the web pages, making the web site
> more maintainable over the long run and providing a viable alternative
> to Java Server Pages <http://java.sun.com/products/jsp/> (JSPs) or PHP
> <http://www.php.net/>./
>
> Does lifespan sound better?
>
> /Velocity separates Java code from the web pages, making the web site
> more maintainable over its lifespan and providing a viable alternative
> to Java Server Pages <http://java.sun.com/products/jsp/> (JSPs) or PHP
> <http://www.php.net/>./
>
> 2. 3rd para... too many 'ands':
>
> / Velocity's capabilities reach well beyond the realm of the web; for
> example, it can be used to generate SQL and PostScript and XML (see
> Anakia <http://jakarta.apache.org/velocity/temp/anakia.html>/ for more
> information on XML transformations) from templates.
>
> becomes:
>
> / Velocity's capabilities reach well beyond the realm of the web; for
> example, it can be used to generate SQL, PostScript and XML (see Anakia
> <http://jakarta.apache.org/velocity/temp/anakia.html> for more
> information on XML transformations) from templates.
> /
> The end of the paragraph has too many 'provides':
>
> /For instance, Velocity provides template services for the Turbine web
> application framework, together providing a view engine facilitating
> development of web applications according to a true MVC model./
>
> Which perhaps should be:
>
> /For instance, Velocity provides templating services for the Turbine web
> application framework; producing a view engine which facilitates
> development of web applications according to a true MVC model./
>
> Not sure about "producing" though. Flame that one away if preferred --
> my thesaurus didn't come up with a word that sounded better.
>
>
> 3. The "Where do I get releases" section:
>
> /The release distribution is available in both |tar.gz| and |zip|
> formats, and are found here./
>
> Should probably be:
>
> /The release distribution is available in both |tar.gz| and |zip|
> formats, and can be found here./
>
>
> 4. The "How do I contribute..." section:
>
> Get rid of the extra "the": /
> Report bugs, ask questions, and help new users on the the Velocity
> mailing lists <http://jakarta.apache.org/getinvolved/mail.html> ./
>
>
> That's just from a quick perusal of the front page...... well you did
> ask for nitpicking.....
>
> J
>
>
> Will Glass-Husain wrote:
>
>>Hi,
>>
>>I've been tinkering with a site redesign for months - I finally got a
>>little more oomph and finished a first cut. It's at
>>http://jakarta.apache.org/velocity/temp/
>>
>>This is both a content and site redesign. The primary goal was to make
>>the web site more accessible to novice users, to remove outdated content,
>>and to clean it up a little.
>>
>>Specifically, I redid the home page, reorganized the TOC, moved all
>>community content to the Wiki, and added a couple of new articles.
>>Product documentation is now 1.4 only. The site format looks the same but
>>has a new logo and is CSS based. Consequently it now prints cleanly with
>>no menu bar. (Thanks, Tim for the logo and the CSS push!)
>>
>>At this point, I could use a little help. First of all - anyone want to
>>volunteer to copyedit (nitpick, please) the new content? That's
>>* Home page
>>* Overview
>>* Getting Started
>>* Web Applications
>>
>>and in the Wiki (just go and and edit)
>>* DocumentationGuidelines
>>
>>Obviously for some of these I cribbed from the Wiki and various earlier
>>web files - thanks to all original authors.
>>
>>Second, I'd appreciate any general comments and fixes. I'm a bit of a CSS
>>positioning novice - suggestions on layout are welcome.
>>
>>One worry I have is links to the user's guide. I've moved it to the
>>"docs14" folder (to allow for multiple versions). I'm going to set up a
>>redirect for all original links to send them to the new file. Hopefully
>>this will work.
>>
>>If the site gets a general thumbs up I'll check it in to source control
>>and then (after a comment period) update the web site.
>>
>>Best, WILL
>>
>>_______________________________________
>>Forio Business Simulations
>>
>>Will Glass-Husain
>>wglass@forio.com
>>www.forio.com
>>
>>
>
---------------------------------------------------------------------
To unsubscribe, e-mail: velocity-dev-unsubscribe@jakarta.apache.org
For additional commands, e-mail: velocity-dev-help@jakarta.apache.org
Re: redesign of web site - comments please
Posted by Jason R Briggs <ja...@gmail.com>.
Hi Will
There's a large column of whitespace on the right-hand side of my screen
(linux+firefox) -- just wanted to check it was intentional?
Here's some nitpick copy-editing for you:
1. Second paragraph on the homepage:
/Velocity separates Java code from the web pages, making the web site
more maintainable over the long run and providing a viable alternative
to Java Server Pages <http://java.sun.com/products/jsp/> (JSPs) or PHP
<http://www.php.net/>./
Does lifespan sound better?
/Velocity separates Java code from the web pages, making the web site
more maintainable over its lifespan and providing a viable alternative
to Java Server Pages <http://java.sun.com/products/jsp/> (JSPs) or PHP
<http://www.php.net/>./
2. 3rd para... too many 'ands':
/ Velocity's capabilities reach well beyond the realm of the web; for
example, it can be used to generate SQL and PostScript and XML (see
Anakia <http://jakarta.apache.org/velocity/temp/anakia.html>/ for more
information on XML transformations) from templates.
becomes:
/ Velocity's capabilities reach well beyond the realm of the web; for
example, it can be used to generate SQL, PostScript and XML (see Anakia
<http://jakarta.apache.org/velocity/temp/anakia.html> for more
information on XML transformations) from templates.
/
The end of the paragraph has too many 'provides':
/For instance, Velocity provides template services for the Turbine web
application framework, together providing a view engine facilitating
development of web applications according to a true MVC model./
Which perhaps should be:
/For instance, Velocity provides templating services for the Turbine web
application framework; producing a view engine which facilitates
development of web applications according to a true MVC model./
Not sure about "producing" though. Flame that one away if preferred --
my thesaurus didn't come up with a word that sounded better.
3. The "Where do I get releases" section:
/The release distribution is available in both |tar.gz| and |zip|
formats, and are found here./
Should probably be:
/The release distribution is available in both |tar.gz| and |zip|
formats, and can be found here./
4. The "How do I contribute..." section:
Get rid of the extra "the": /
Report bugs, ask questions, and help new users on the the Velocity
mailing lists <http://jakarta.apache.org/getinvolved/mail.html> ./
That's just from a quick perusal of the front page...... well you did
ask for nitpicking.....
J
Will Glass-Husain wrote:
>Hi,
>
>I've been tinkering with a site redesign for months - I finally got a little more oomph and finished a first cut. It's at
>http://jakarta.apache.org/velocity/temp/
>
>This is both a content and site redesign. The primary goal was to make the web site more accessible to novice users, to remove outdated content, and to clean it up a little.
>
>Specifically, I redid the home page, reorganized the TOC, moved all community content to the Wiki, and added a couple of new articles. Product documentation is now 1.4 only. The site format looks the same but has a new logo and is CSS based. Consequently it now prints cleanly with no menu bar. (Thanks, Tim for the logo and the CSS push!)
>
>At this point, I could use a little help. First of all - anyone want to volunteer to copyedit (nitpick, please) the new content? That's
>* Home page
>* Overview
>* Getting Started
>* Web Applications
>
>and in the Wiki (just go and and edit)
>* DocumentationGuidelines
>
>Obviously for some of these I cribbed from the Wiki and various earlier web files - thanks to all original authors.
>
>Second, I'd appreciate any general comments and fixes. I'm a bit of a CSS positioning novice - suggestions on layout are welcome.
>
>One worry I have is links to the user's guide. I've moved it to the "docs14" folder (to allow for multiple versions). I'm going to set up a redirect for all original links to send them to the new file. Hopefully this will work.
>
>If the site gets a general thumbs up I'll check it in to source control and then (after a comment period) update the web site.
>
>Best, WILL
>
>_______________________________________
>Forio Business Simulations
>
>Will Glass-Husain
>wglass@forio.com
>www.forio.com
>
>