chunked guide / docs.macports.org?

[William Siegrist]

On Jul 28, 2008, at 5:01 PM, Ryan Schmidt wrote:

> On Jul 28, 2008, at 18:14, markd at macports.org wrote:
>
>> Simon has got the details of the chunked guide worked out, and I am
>> of the
>> opinion that it is better that guide.macports.org display the chunked
>> guide with an obvious link somewhere to the single-page version, as
>> opposed to the guide.macports.org pulling up a page that asks
>> 'single-page
>> or multi-page?'  I prefer to provide the chunked guide as a sane
>> default.
>> Do you agree or disagree with this?
>>
>> Also, I am thinking that maybe we need a docs.macports.org url to
>> track
>> all our documents.  I know Jordan mentioned we should link the
>> HOWTOs in
>> the Guide, but I think it might be better to link a more general
>> docs page
>> there and perhaps elsewhere.  Opinions?
>
> I would prefer that we gravitate towards less hostnames, not more.
>
> Our documentation is currently in the Guide (guide.macports.org) and
> in the wiki (trac.macports.org/wiki). Do we really need another page
> that provides just those two links?
>
> Maybe it would make sense to have a wiki page which provides links to
> all documentation.



I agree with Ryan. Why not try to standardize on something like <http://macports.org/docs/ 
 >  for everything? That page could contain links into the Trac wiki,  
guide, FAQ, whatever. The main page at macports.org would have a  
single "Documentation" link to that page. We could even move the  
guide(s) into <http://macports.org/docs/guide/>.

-Bill


-------------- next part --------------
A non-text attachment was scrubbed...
Name: smime.p7s
Type: application/pkcs7-signature
Size: 2421 bytes
Desc: not available
Url : http://lists.macosforge.org/pipermail/macports-dev/attachments/20080728/26fd74ce/attachment-0001.bin