On 22/10/2007, at 20.39, IOhannes m zmölnig wrote:
Steffen Juul wrote:
On 22/10/2007, at 11.34, IOhannes m zmoelnig wrote:
a note on layout: i think that the faq should be directly in ./docs/faq and not in ./doc/faq/faq-pd/...)
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?
That would also reflect the layout (and contents) of ./docs/manuals
by accident (well, i happened to be in the ./docs section today) i stumbled across the ./docs/manual.
it consisted of 3 entries:
- Pd manual
- Gem manual (empty)
- pure-data.org manual (empty, but the description has obviously bee
last updated when pure-data.org was still relevant which is some years ago)
i have updated the sections (added puredata.info and put a link to the "site docs" in there, so there is at least some valuable information if you go there; fixed pure-data.org; added a link in the "Gem manual" to actually point to the Gem manual)
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?
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.