MacPorts Wiki TOC - was Re(2): problems with gtk

Juan Manuel Palacios <[email protected]> writes:
>> Or How about a top level section "Setting Your Mac Ready for MacPorts"
>>
>> I)  Getting Your Mac Ready for MacPorts
>>
>> 1) Install Xcode Tools
>> 2) Install the MacPorts Binary
>> 3) Installing X11 and setting the shell (optional)
>>
>> II) Using MacPorts (Joe's Getting Started section)
>>
>> I like that even better.  What do y'all think?
>>
>> Mark
>>
>
>	Admittedly not having read too deep into your propositions, I'd say=20
>"go for it!" ;-) We're all with our plates rather full at the moment,=20
>including you with all the great work you've been putting into the=20
>project, so we're gladly accepting as much help as we can get. I'm in=20
>the slow process of migrating each doc in our OpenDarwin Wiki to trac=20
>and thus have realized how outdated they are; any effort to bring them=20
>up to speed is more than welcomed ;-)

Ok, cool.  Well you may regret encouraging me, because I have some more
thoughts on the existing Trac main page so I'm going to expand on what I
said earlier.  One thing I think is really important is clarity in the
structure of the Trac main page because it is really a "table of
contents".  A clear one will go a long way.

I think the section title "MacPorts Starting Points" implies introductory
material.  But right now it doesn't seem to mean introductory material
because some introduictory material is in the next section.  But I like
the term and I think the info on the main page needs rearranging anyway,
so after rearranging I think ithe whole thing is more clear.

*** MacPorts Support ***

** MacPorts Starting Points **

I) Home Page
II) Getting Your Mac Ready for MacPorts
	1) Install Xcode Tools
	2) Install the MacPorts Binary
	3) Installing X11 and setting the shell (optional)

II) Using MacPorts (Joe's Getting Started section)
III) FAQ

** MacPorts Support and Development **

I) MacPorts Internals
	1) Build Phases
II) Making Portfiles (or Portfile examples if that is too challenging)
III) MacPorts Guide (enhanced legacy guide)
IV) New Committer's Guide
V) Developer FAQ
VI) Legacy Site, Docs, etc


I don't think "Trac Starting Points" belongs in the MacPorts Support
hierarchy.  And most people won't care about this so I wouldn't let it
compete for space with MacPorts material.  Perhaps shrink it to a single
"Trac System Support" link that doesn't make it seem like you'd need to g=
o
there because you don't.  Not sure how to do that though.

What do you think?

Mark