Re: [gentoo-dev] FAQs for maintainer-wanted ebuilds

2005-09-14 Thread Sven Vermeulen
On Mon, Sep 12, 2005 at 05:55:42PM +0100, Ciaran McCreesh wrote:
> No. GuideXML URLs utterly suck. They're impossible to memorise and the
> second I changed anything every link would become invalid.

But at least the layout is consistent, the location is official, concurrent
development is possible and the resource is shared on multiple web nodes.

Not to mention that GuideXML URLs don't suck and are a lot easier to
remember. You just need to know the name of the document:
  http://www.gentoo.org/doc/en/
whereas with dev.g.o URLs, you have
  http://dev.gentoo.org/~//

Wkr,
  Sven Vermeulen

-- 
  Gentoo Foundation Trustee  |  http://foundation.gentoo.org
  Gentoo Documentation Project Lead  |  http://www.gentoo.org/proj/en/gdp
  Gentoo Council Member  

  The Gentoo Project   <<< http://www.gentoo.org >>>


pgpnYiyWs4wJm.pgp
Description: PGP signature


Re: [gentoo-dev] FAQs for maintainer-wanted ebuilds

2005-09-12 Thread Jan Kundrát
Ciaran McCreesh wrote:
> No. GuideXML URLs utterly suck. They're impossible to memorise and the
> second I changed anything every link would become invalid.

Please see our XML guide [1] - you can use "id" attribute and make links
like "file.xml#reboot".

[1] http://www.gentoo.org/doc/en/xml-guide.xml#doc_chap2_sect9

Cheers,
-jkt

-- 
cd /local/pub && more beer > /dev/mouth


signature.asc
Description: OpenPGP digital signature


Re: [gentoo-dev] FAQs for maintainer-wanted ebuilds

2005-09-12 Thread Ciaran McCreesh
On Mon, 12 Sep 2005 09:03:17 +0200 Martin Schlemmer <[EMAIL PROTECTED]>
wrote:
| Looks good .. any chance you can stitch it up in a guide, and we can
| get it added somewhere ?

No. GuideXML URLs utterly suck. They're impossible to memorise and the
second I changed anything every link would become invalid.

-- 
Ciaran McCreesh : Gentoo Developer (Vim, Shell tools, Fluxbox, Cron)
Mail: ciaranm at gentoo.org
Web : http://dev.gentoo.org/~ciaranm



pgpFDDw0LblPl.pgp
Description: PGP signature


Re: [gentoo-dev] FAQs for maintainer-wanted ebuilds

2005-09-12 Thread Ciaran McCreesh
On Mon, 12 Sep 2005 14:44:04 +0300 Ivan Yosifov <[EMAIL PROTECTED]>
wrote:
| licence.txt 11-Sep-2005 22:27  745 
| license.txt 11-Sep-2005 22:27  745 
| 
| I guess one should go away.

It's a symlink. That way it works even if I accidentally forget to
misspell the URL when I'm typing it in.

-- 
Ciaran McCreesh : Gentoo Developer (Vim, Shell tools, Fluxbox, Cron)
Mail: ciaranm at gentoo.org
Web : http://dev.gentoo.org/~ciaranm



pgp4jNlZiQprc.pgp
Description: PGP signature


Re: [gentoo-dev] FAQs for maintainer-wanted ebuilds

2005-09-12 Thread Ivan Yosifov
On Mon, 2005-09-12 at 14:44 +0300, Ivan Yosifov wrote:
> On Sun, 2005-09-11 at 22:41 +0100, Ciaran McCreesh wrote:
> > I've put together a kind of FAQ for the most common maintainer-wanted
> > problems:
> > 
> > http://dev.gentoo.org/~ciaranm/docs/mw-faq/
> > 
> > The idea is to replace most of my usual bullet points in the "please
> > fix" list with URLs with more complete explanations.
> > 
> > Any additions or suggestions for changes would be appreciated. Please
> > do not GuideXMLify this unless you first make XML not suck. I like my
> > nice sane memorisable consistent URLs and quickly updateable content.
> > 
> 
> licence.txt 11-Sep-2005 22:27  745 
> license.txt 11-Sep-2005 22:27  745 
> 
> I guess one should go away.

I should have opened the file before sending the message, sorry.

* It's misspelt LICENSE. We all know that LICENCE is the real way of spelling
  it, but Portage expects LICENSE.

At least according to my dictionary, LICENSE is the American spelling and 
LICENCE is the British.
In this sense both are correct ( "we all know that" ).

-- 
Cheers,
Ivan Yosifov.

-- 
gentoo-dev@gentoo.org mailing list



Re: [gentoo-dev] FAQs for maintainer-wanted ebuilds

2005-09-12 Thread Ivan Yosifov
On Sun, 2005-09-11 at 22:41 +0100, Ciaran McCreesh wrote:
> I've put together a kind of FAQ for the most common maintainer-wanted
> problems:
> 
> http://dev.gentoo.org/~ciaranm/docs/mw-faq/
> 
> The idea is to replace most of my usual bullet points in the "please
> fix" list with URLs with more complete explanations.
> 
> Any additions or suggestions for changes would be appreciated. Please
> do not GuideXMLify this unless you first make XML not suck. I like my
> nice sane memorisable consistent URLs and quickly updateable content.
> 

licence.txt 11-Sep-2005 22:27  745 
license.txt 11-Sep-2005 22:27  745 

I guess one should go away.


-- 
Cheers,
Ivan Yosifov.

-- 
gentoo-dev@gentoo.org mailing list



Re: [gentoo-dev] FAQs for maintainer-wanted ebuilds

2005-09-12 Thread Martin Schlemmer
On Sun, 2005-09-11 at 22:41 +0100, Ciaran McCreesh wrote:
> I've put together a kind of FAQ for the most common maintainer-wanted
> problems:
> 
> http://dev.gentoo.org/~ciaranm/docs/mw-faq/
> 
> The idea is to replace most of my usual bullet points in the "please
> fix" list with URLs with more complete explanations.
> 
> Any additions or suggestions for changes would be appreciated. Please
> do not GuideXMLify this unless you first make XML not suck. I like my
> nice sane memorisable consistent URLs and quickly updateable content.
> 

Looks good .. any chance you can stitch it up in a guide, and we can get
it added somewhere ?


-- 
Martin Schlemmer



signature.asc
Description: This is a digitally signed message part


[gentoo-dev] FAQs for maintainer-wanted ebuilds

2005-09-11 Thread Ciaran McCreesh
I've put together a kind of FAQ for the most common maintainer-wanted
problems:

http://dev.gentoo.org/~ciaranm/docs/mw-faq/

The idea is to replace most of my usual bullet points in the "please
fix" list with URLs with more complete explanations.

Any additions or suggestions for changes would be appreciated. Please
do not GuideXMLify this unless you first make XML not suck. I like my
nice sane memorisable consistent URLs and quickly updateable content.

-- 
Ciaran McCreesh : Gentoo Developer (Vim, Shell tools, Fluxbox, Cron)
Mail: ciaranm at gentoo.org
Web : http://dev.gentoo.org/~ciaranm


pgpr6uZXgjuys.pgp
Description: PGP signature