[gentoo-dev] FAQs for maintainer-wanted ebuilds

[gentoo-dev] FAQs for maintainer-wanted ebuilds

[Ciaran McCreesh]

[-- Attachment #1: Type: text/plain, Size: 638 bytes --]

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

[-- Attachment #2: Type: application/pgp-signature, Size: 189 bytes --]

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

[Martin Schlemmer]

[-- Attachment #1: Type: text/plain, Size: 682 bytes --]

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


[-- Attachment #2: This is a digitally signed message part --]
[-- Type: application/pgp-signature, Size: 189 bytes --]

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

[Ciaran McCreesh]

[-- Attachment #1: Type: text/plain, Size: 485 bytes --]

On Mon, 12 Sep 2005 09:03:17 +0200 Martin Schlemmer <azarah@gentoo.org>
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


[-- Attachment #2: Type: application/pgp-signature, Size: 189 bytes --]

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

[Jan Kundrát]

[-- Attachment #1: Type: text/plain, Size: 378 bytes --]

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

[-- Attachment #2: OpenPGP digital signature --]
[-- Type: application/pgp-signature, Size: 256 bytes --]

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

[Sven Vermeulen]

[-- Attachment #1: Type: text/plain, Size: 883 bytes --]

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/<document>
whereas with dev.g.o URLs, you have
  http://dev.gentoo.org/~<user>/<path>/<document>

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 >>>

[-- Attachment #2: Type: application/pgp-signature, Size: 189 bytes --]

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

[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

[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

[Ciaran McCreesh]

[-- Attachment #1: Type: text/plain, Size: 494 bytes --]

On Mon, 12 Sep 2005 14:44:04 +0300 Ivan Yosifov <ivan@yosifov.net>
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


[-- Attachment #2: Type: application/pgp-signature, Size: 189 bytes --]