From owner-freebsd-gnome@FreeBSD.ORG Tue Apr 8 19:45:16 2003 Return-Path: Delivered-To: freebsd-gnome@freebsd.org Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id 5FD3737B401 for ; Tue, 8 Apr 2003 19:45:16 -0700 (PDT) Received: from ms-smtp-03.southeast.rr.com (ms-smtp-03.southeast.rr.com [24.93.67.84]) by mx1.FreeBSD.org (Postfix) with ESMTP id 3D1D943F85 for ; Tue, 8 Apr 2003 19:45:15 -0700 (PDT) (envelope-from marcus@marcuscom.com) Received: from mail4.nc.rr.com (fe4 [24.93.67.51])h392i1Mq013461; Tue, 8 Apr 2003 22:44:01 -0400 (EDT) Received: from creme-brulee.marcuscom.com ([66.57.17.158]) by mail4.nc.rr.com with Microsoft SMTPSVC(5.5.1877.757.75); Tue, 8 Apr 2003 22:47:01 -0400 Received: from [192.168.1.4] (shumai.marcuscom.com [192.168.1.4]) h392ij7q074746; Tue, 8 Apr 2003 22:44:46 -0400 (EDT) (envelope-from marcus@marcuscom.com) From: Joe Marcus Clarke To: "Mezz bsdforums.org" In-Reply-To: References: Content-Type: multipart/signed; micalg=pgp-sha1; protocol="application/pgp-signature"; boundary="=-xKOfNGptes3lSQwSTiT1" Organization: MarcusCom, Inc. Message-Id: <1049856307.65188.17.camel@shumai.marcuscom.com> Mime-Version: 1.0 X-Mailer: Ximian Evolution 1.2.4 Date: 08 Apr 2003 22:45:07 -0400 X-Spam-Status: No, hits=-38.6 required=5.0 tests=BAYES_10,EMAIL_ATTRIBUTION,IN_REP_TO,PGP_SIGNATURE_2, QUOTED_EMAIL_TEXT,QUOTE_TWICE_1,REFERENCES, REPLY_WITH_QUOTES autolearn=ham version=2.50 X-Spam-Checker-Version: SpamAssassin 2.50 (1.173-2003-02-20-exp) cc: FreeBSD GNOME Users Subject: Re: Documentation needed! (about the left side menu) X-BeenThere: freebsd-gnome@freebsd.org X-Mailman-Version: 2.1.1 Precedence: list List-Id: GNOME for FreeBSD -- porting and maintaining List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Wed, 09 Apr 2003 02:45:16 -0000 --=-xKOfNGptes3lSQwSTiT1 Content-Type: text/plain; charset=ISO-8859-1 Content-Transfer-Encoding: quoted-printable On Tue, 2003-04-08 at 18:03, Mezz bsdforums.org wrote: > >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. >=20 > I took the look at SGML and it's ok (I dislike SGML ;-)). It's limit when= =20 > use FreeBSD.org's header and stuff. So, looks like add a simple light gre= y=20 > table with blockquote should look ok and good without any of fancy table=20 > with shadow. >=20 > So... What are you (guys/gals) want to work on? Try to avoid work on the=20 > same things. >=20 > Current, I am thinking about work on the left side menu. Need to turn=20 > sentence into a simple words and smaller. Like this: >=20 > Change from... > =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D > GNOME on FreeBSD > =B7 GNOME on FreeBSD Home > =B7 Installation Instructions for GNOME 1.4 > =B7 Installation Instructions for GNOME 2.2 > =B7 Available Applications > =B7 How to Help > =B7 Reporting a Bug > =B7 Screenshots > =B7 Contact Us >=20 > Documentation > =B7 GNOME 1.4 FAQ > =B7 GNOME 2.2 FAQ > =B7 Creating Ports > =B7 Known Issues with GNOME 2.2 on FreeBSD >=20 > Resources > =B7 GNOME Project > =B7 GNOME Office > =B7 GNOME on GNU/Darwin >=20 > Related Projects > =B7 KDE Project > =B7 KDE on FreeBSD > =B7 CDE (commercial) > =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D >=20 > to... > =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D > GNOME on FreeBSD > =B7 GNOME on FreeBSD Home > =B7 Available Applications > =B7 How to Help > =B7 Reporting a Bug > =B7 Screenshots > =B7 Contact Us >=20 > Gnome 1.4 Documentation [1] > =B7 Handbook [2] > =B7 Installtion [3] > =B7 Creating Ports [4] > =B7 FAQ > =B7 Known Issues [5] >=20 > Gnome 2.2 Documentation [1] > =B7 Handbook [2] > =B7 Installtion [3] > =B7 Creating Ports [4] > =B7 FAQ > =B7 Known Issues [5] >=20 > Resources > =B7 GNOME Project > =B7 GNOME Office > =B7 GNOME on GNU/Darwin >=20 > Related Projects > =B7 KDE Project > =B7 KDE on FreeBSD > =B7 CDE (commercial) > =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D Yes! This looks great. >=20 > -[1] I think, they need to be seperate to make easier to surf and read. I agree. >=20 > -[2] How about create a 'small version' handbook of Gnome 1.x and 2.x on=20 > FreeBSD? I think, the FAQ need to split and FAQ should be for known stuff= ,=20 > quick/short and etc (feel free to correct me). One of the items for the project todo (that I signed up for a long time ago, but never did) was to convert the FAQ to Docbook. If you want to pick up the cause, you won't hear any objections from me. >=20 > Which, meaning some of us can write more stuff. Short of walk-throught li= ke=20 > FreeBSD's offical handbook. Maybe, later if it can merges in the offical=20 > handbook. Perhaps, some better word(s) instead use 'Handbook' to avoid th= e=20 > confuse? I think keeping it separate is the way to go. Having a link to it the handbook is probably good enough. >=20 > -[3] I think, it should be under the 'Documentation' area. :-) This link=20 > points to the 'short version' handbook of Gnome 1.x and 2.x on FreeBSD. Okay. >=20 > -[4] Not sure how it should work. Point to FAQ or 'small version' handboo= k?=20 > methink should be in the 'small version' handbook. This should be a separate guide much like the porter's handbook is now. >=20 > -[5] If there's none, remove it. Or "gray" it out. >=20 > Should we add two more links to point at Gnome's 1.x and 2.x doc website?= =20 > Like, add under 'Known Issue' or 'Resources'. Sounds like a good idea. >=20 > Any feedback on this? What's your thought? >=20 > Hey Joe, can you add in something like freebsd.org/gnome/test/ or else? S= o,=20 > we can send the diff to you, then you upload stuff there while it will ha= ve=20 > some broke links and etc. I have the whole site mirrored at http://www.marcuscom.com/gnome. Send me diffs, and I'll post them there. Not to be an ass, but we need something for the new infrastructure pretty soon so we can let other porters know what's up. Thanks! Joe >=20 > Cheers, > Mezz >=20 > >Joe > > > >-- > >Joe Marcus Clarke > >FreeBSD GNOME Team :: marcus@FreeBSD.org > >http://www.FreeBSD.org/gnome >=20 > _________________________________________________________________ > MSN 8 with e-mail virus protection service: 2 months FREE* =20 > http://join.msn.com/?page=3Dfeatures/virus >=20 > _______________________________________________ > freebsd-gnome@freebsd.org mailing list > http://lists.freebsd.org/mailman/listinfo/freebsd-gnome > To unsubscribe, send any mail to "freebsd-gnome-unsubscribe@freebsd.org" --=20 PGP Key : http://www.marcuscom.com/pgp.asc --=-xKOfNGptes3lSQwSTiT1 Content-Type: application/pgp-signature; name=signature.asc Content-Description: This is a digitally signed message part -----BEGIN PGP SIGNATURE----- Version: GnuPG v1.2.1 (FreeBSD) iD8DBQA+k4kyb2iPiv4Uz4cRAu2QAKCtJT6AdfKcxT2lkJs/o03Yb6X1ZACeJfz5 cHyWKysTvf+BrWVf9/rZisQ= =RUlr -----END PGP SIGNATURE----- --=-xKOfNGptes3lSQwSTiT1--