[Freeciv-Dev] Re: Irritatingly long file names

[Vasco Alexandre Da Silva Costa <vasc@xxxxxxxxxxxxxx>]

On Thu, 17 Jan 2002, Gregory Berkolaiko wrote:

>  --- "Per I. Mathisen" <Per.Inge.Mathisen@xxxxxxxxxxx> wrote: 
> 
> [..]
> 
> > > How about the 'freeciv_hackers_guide.txt' does everyone agree with
> > the superb
> > > README.hacking name suggested by Jason?
> > 
> > It is better, but I don't really like to prefix it with README. Perhaps
> > we
> > can create a new directory docs/ for documents that only programmers
> > are
> > meant to read? coding_style.text and hackers_guide.text (my suggestions
> > for names) would go in there in the begining. the hackers_guide should
> > also be split up into multiple files for better readability.
> 
> This is the right way to do it I think.  README.ai also belongs there
> (although it's bloody useless).  And inside docs the names can be any
> length without irritating Vasc, hopefully.
> 
> BTW, don't split hackers_guide, it's not at all long.

If we do it in this fashion please choose a .txt or .doc extension for the
benefit of poor MS users. This means we must either:

a) change the style of files like HOWTOPLAY to for e.g. playing_intro.txt
b) change the style of those above to e.g. CODING_STYLE and HACKING.

Oh and yes, it doesn't annoy me to move things to doc/. I find it that the
main directory is starting to get cluttered. And i don't like to mix name
styles, or have redundant text. :-)

---
Vasco Alexandre da Silva Costa @ Instituto Superior Tecnico, Lisboa