[drupal-docs] Troubleshooting faq section (needs to be condensed)

[Anisa]

Actually, they should all have .txt extensions, because it's part of the 
coding standards.

I will double check, but several of the modules I have downloaded don't 
have them.

Let's see...  For example: 
http://cvs.drupal.org/viewcvs/drupal/contributions/modules/taxonomy_context/

It looks like the readme file has changed (per some discussion on the 
devel list), but the install file is still extension-less.

I am all for going through and changing them to have .txt after them and 
getting the same treatment as the readme files, but so long as there are 
extensionless files, there will be a bit of confusion.  For us poor 
windows users at any rate.  ;)

Anisa.

Steven Wittens wrote:

>
>> I like the part where Anisa splits into PHPMyAdmin and command line. 
>> But for this too, we would need some style guides.  
>>
> I can think of one style guide item already: never show the command 
> line prompt in the instructions. People tend to copy/paste them, and 
> it is much better to use e.g. a monospace font to distinguish command 
> line text from plain text.
>
> The bit about missing .txt extensions seems a bit obsolete to me. As 
> far as I can tell, every readme file in contrib has had the .txt 
> extension since 4.5.
>
> Steven Wittens
>
>