Documentation needed! (about the left side menu)

[Mezz bsdforums.org]

>Calling all documentation volunteers!  I committed the new bsd.gnome.mk
>last night, and I'd like to get the documentation online as soon as
>possible.  This way, porters can start using the new infrastructure.  So
>far, Mezz, Adam, and Piero have volunteered.  Please let me know if you
>need any help with the content.  I'll rely on your creative juices for
>the wording and layout.  The format must be consistent with the FreeBSD
>CSS style, and diffs should be submitted against the SGML code in
>www/en/gnome.  Thanks.

I took the look at SGML and it's ok (I dislike SGML ;-)). It's limit when 
use FreeBSD.org's header and stuff. So, looks like add a simple light grey 
table with blockquote should look ok and good without any of fancy table 
with shadow.

So... What are you (guys/gals) want to work on? Try to avoid work on the 
same things.

Current, I am thinking about work on the left side menu. Need to turn 
sentence into a simple words and smaller. Like this:

Change from...
=======================
GNOME on FreeBSD
· GNOME on FreeBSD Home
· Installation Instructions for GNOME 1.4
· Installation Instructions for GNOME 2.2
· Available Applications
· How to Help
· Reporting a Bug
· Screenshots
· Contact Us

Documentation
· GNOME 1.4 FAQ
· GNOME 2.2 FAQ
· Creating Ports
· Known Issues with GNOME 2.2 on FreeBSD

Resources
· GNOME Project
· GNOME Office
· GNOME on GNU/Darwin

Related Projects
· KDE Project
· KDE on FreeBSD
· CDE (commercial)
=======================

to...
=======================
GNOME on FreeBSD
· GNOME on FreeBSD Home
· Available Applications
· How to Help
· Reporting a Bug
· Screenshots
· Contact Us

Gnome 1.4 Documentation [1]
· Handbook [2]
· Installtion [3]
· Creating Ports [4]
· FAQ
· Known Issues [5]

Gnome 2.2 Documentation [1]
· Handbook [2]
· Installtion [3]
· Creating Ports [4]
· FAQ
· Known Issues [5]

Resources
· GNOME Project
· GNOME Office
· GNOME on GNU/Darwin

Related Projects
· KDE Project
· KDE on FreeBSD
· CDE (commercial)
=======================

-[1] I think, they need to be seperate to make easier to surf and read.

-[2] How about create a 'small version' handbook of Gnome 1.x and 2.x on 
FreeBSD? I think, the FAQ need to split and FAQ should be for known stuff, 
quick/short and etc (feel free to correct me).

Which, meaning some of us can write more stuff. Short of walk-throught like 
FreeBSD's offical handbook. Maybe, later if it can merges in the offical 
handbook. Perhaps, some better word(s) instead use 'Handbook' to avoid the 
confuse?

-[3] I think, it should be under the 'Documentation' area. :-) This link 
points to the 'short version' handbook of Gnome 1.x and 2.x on FreeBSD.

-[4] Not sure how it should work. Point to FAQ or 'small version' handbook? 
methink should be in the 'small version' handbook.

-[5] If there's none, remove it.

Should we add two more links to point at Gnome's 1.x and 2.x doc website? 
Like, add under 'Known Issue' or 'Resources'.

Any feedback on this? What's your thought?

Hey Joe, can you add in something like freebsd.org/gnome/test/ or else? So, 
we can send the diff to you, then you upload stuff there while it will have 
some broke links and etc.

Cheers,
Mezz

>Joe
>
>--
>Joe Marcus Clarke
>FreeBSD GNOME Team	::	marcus at FreeBSD.org
>http://www.FreeBSD.org/gnome

_________________________________________________________________
MSN 8 with e-mail virus protection service: 2 months FREE*  
http://join.msn.com/?page=features/virus