Steffen Juul wrote:
problem is the there something called ./docs/FAQ which is the GEM faq.
hmm, but the GEM FAQ is somewhere else, so i don't really understand the problem.
The fact that http://puredata.info/docs/faq and http://puredata.info/docs/FAQ are too different FAQs is a problem, as i see it.
Fair enough that the system is case sensitive. But the meaning, here, is not. The one is the GEM FAQ while the other is the Pd FAQ. And even if you'd argue that meaning is case sensitive, then there is nothing in FAQ that says GEM as much as here is nothing in faq that says Pd. Hence how do you distinguish the two by look at URL/name of the folder they are in/their location on puredata.info?
i totally agree. i have no idea how the Gem-FAQ made it into ./docs/FAQ imho,it should be removed, "FAQ" should point to "faq", and one entry in the pd-FAQ would be "Where is the Gem FAQ?" which should point to the correct ressource http://gem.iem.at/documentation/faq/
Great work. I must have been there after you made those changes. I've add the some more 'links' from the ./docs/FrontPage as i hope to get rid of it in the future.
Btw: I don't know if there is any good reason to not 1) delete the pure-data.org link and 2) move the Site Howtos section/folder into the puredata.info folder?
no objections for 1), but 2) is more problematic, we should check how often this site is referred to.
all in all i don't think we have to stick to the layout of docs/manuals/ because of it's wide acceptance :-)
I'm just trying to sort things out a bit. Even though it might be rough to delete things and move things about. But i'd rather clear/clean things up then keep old URLs working on third-party sites. Having the ./manual and /faq sections reflect each other is, in my world, a good and clear'ed thing.
Anyways, a desire for some symmetry between those sections wasn't a "have to" such that a argument against it would ditch the ./faq layout i suggested.
i see your point. however, i have come to the conclusion, that the flatter the structure the better it will eventually work. i find it quite frustrating to have a deep hierarchy of directories, only to have one entry at the bottom of the well. (i guess this is a german-english pidgin)
as for making ./faq and ./manual in synch, i would suggest that none of them have any further subdirectories ./docs/manual == Pd manual ./docs/faq == Pd FAQ
that's it; no confusion with other documentation of other (though related) projects which are not updated anyhow...
mfga.dsr IOhannes