[prev in list] [next in list] [prev in thread] [next in thread] 

List:       macports-dev
Subject:    Re: chunked guide - macports.org/docs/
From:       William Siegrist <wsiegrist () apple ! com>
Date:       2008-07-31 20:30:37
Message-ID: 3F8291C1-A36D-473B-985A-94B6AB0F8ACE () apple ! com
[Download RAW message or body]

[Attachment #2 (multipart/signed)]


On Jul 31, 2008, at 12:46 AM, Ryan Schmidt wrote:

> On Jul 30, 2008, at 11:23, markd@macports.org wrote:
>
>>> My idea was for /docs/ to be static HTML/PHP  in the repo which
>>> renders to something like:
>>>
>>>
>>> Documentation:
>>> 	* Installation
>
>
>
>>> So this /docs/ page would replace several left navigation links on
>>> macports.org. The existing Documentation link would point to /docs/
>>> and the above list.
>>
>> I like this idea.  One benefit would be that it would allow us to  
>> unify
>> the install information (guide & website are different), which  
>> needs to be
>> done anyway.
>
>
> I would recommend that before we create a documentation index page,  
> we consolidate our documentation and not have three or four distinct  
> URLs describing the same basic things. A lot of the Guide was taken  
> from Wiki pages, so the Wiki pages that the Guide obsoletes should  
> be cleared of their contents and replaced with a link to the  
> appropriate Guide section (after ensuring that all content from the  
> Wiki pages has made it into the corresponding Guide sections).
>
>

I added <http://macports.org/docs.php> which just lists all of the  
URLs Ryan listed. That page isnt linked to from anywhere, so for now  
we can use it to track all of the docs we have as we try to shorten  
the list.

> So www.macports.org/docs would list the available documentation. And  
> the Guide would be where? Still at guide.macports.org? Or would it  
> move to www.macports.org/guide? or www.macports.org/docs/guide? An  
> advantage I think of keeping the Guide on its own hostname is that  
> you can limit a Google search to just that hostname, so you get just  
> Guide results. If we move the Guide to www.macports.org/whatever,  
> can we still make a Google search that just searches the Guide?
>

In keeping with current convention, its "/docs.php".  We can keep  
guide.macports.org, but use "/single" and "/chunked"? I can add a  
redirect so it defaults to one or the other when visiting just http://guide.macports.org/ 
. I guess the consensus so far is to default to chunked?

> The wiki would stay at trac.macports.org/wiki? Or would you want it  
> to move to www.macports.org/wiki? or www.macports.org/docs/wiki? I'm  
> not sure if we can or should move the wiki URL independent of the  
> rest of the Trac URLs.
>

Its possible to serve out the Trac wiki from www.macports.org, but  
probably not worth the effort. I think trac.macports.org should stay.  
Other projects do this, but usually have a generic name like  
"code.macports.org" so its not branded with the app you happen to be  
using. What would be nice is if the two sites shared styles so they  
look similar, I just dont have a lot of time right now to do that.  
Maybe after Trac 0.11 since I have to redo all the templates anyway.


-Bill




["smime.p7s" (smime.p7s)]

0	*H
 010	+0	*H
 '00I -o uc'u0
	*H
0b10	UZA1%0#U
Thawte Consulting (Pty) Ltd.1,0*U#Thawte Personal Freemail Issuing CA0
080721193351Z
090721193351Z0E10UThawte Freemail Member1"0 	*H
	wsiegrist@apple.com0"0
	*H
0
܋؊n ~CbvwRzE	`ڗݰ6mL6smx~41oU9CT`D,;%typf \
)P,.o\y-Gg;$:c\?-a \
:k4q*Zk=e7ٴx6XxY]*9v1=8Șxi62dT28m̻0+N5 \
^Kɉ?EMM5:P \
-m00.0U0wsiegrist@apple.com0U00 	*H
'da-6~)>"aQlNssn6j竺6ԢW	Yѱ%nU]
 *AKB(]@vSKL>
U~<1C9.'yx0?0 
0
	*H
010	UZA10UWestern Cape10U	Cape Town10U
Thawte Consulting1(0&UCertification Services Division1$0"UThawte \
Personal Freemail CA1+0)	*H 	personal-freemail@thawte.com0
030717000000Z
130716235959Z0b10	UZA1%0#U
Thawte Consulting (Pty) Ltd.1,0*U#Thawte Personal Freemail Issuing CA00
	*H
0Ħ<UsUNʙZhup[v:aQP
0cZ,p+Z?qV˯<6$*+w=+>@dקe*TH<a@dr`00U00CU<0:08 \
6 42http://crl.thawte.com/ThawtePersonalFreemailCA.crl0U0)U"0 \
010UPrivateLabel2-1380 	*H
HP.
fg CL!6-6/P p<ab:~t%Pb'qW%ݩ9 \
Oe_N4[5MwV!x!5$F]_eO100v0b10	UZA1%0#U \
Thawte Consulting (Pty) Ltd.1,0*U#Thawte Personal Freemail Issuing CA-o \
uc'u0	+ o0	*H 	1	*H
0	*H
	1
080731203038Z0#	*H
	1%0·ZP66ym80	+71x0v0b10	UZA1%0#U
Thawte Consulting (Pty) Ltd.1,0*U#Thawte Personal Freemail Issuing CA-o \
uc'u0*H 	1x v0b10	UZA1%0#U
Thawte Consulting (Pty) Ltd.1,0*U#Thawte Personal Freemail Issuing CA-o \
uc'u0 	*H
S
鐄"9Y
P. bI*FE`/nlZf\Tc(ve<zuO"?Lf&#jtLDi͚kي9ye3Bg)Rt'0A{~œޚ˒rfPtGEwZEJ#dfJe#ֵ
 -mim)@ &2Wyj$8)6,2Ⱦ$^C~`VA(
 K+~-U@K



_______________________________________________
macports-dev mailing list
macports-dev@lists.macosforge.org
http://lists.macosforge.org/mailman/listinfo.cgi/macports-dev


[prev in list] [next in list] [prev in thread] [next in thread]

Configure | About | News | Add a list | Sponsored by KoreLogic