[Pdweb] Pd-FAQ [was; Re: puredata.org survey]

[IOhannes m zmölnig]

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