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

[Steffen Juul]

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.