Hi! We currently have the following text in the footer of every doc:
Would you like to make a comment or contribute an update to this page? Send feedback to the _KDE Docs Team_ <mailto:kde-doc-english at kde.org> I think this is part of the reason why we get so many off topic posts to this list. I'd like to add a new chapter to the KDE Fundamentals documentation that includes two things: 1. A list of resources for getting further assistance with KDE, linking to the KDE forums, appropriate mailing lists, bugzilla, etc. 2. A brief overview of how to submit feedback to KDE Documentation Team, including this e-mail address We could then change the footer in kdelibs.git to read something like this: For further assistance using this or any other KDE application, see _Getting Help_. <help:/fundamentals/support.html> Would you like to make a comment or contribute an update to this page? See _Contacting the Documentation Team_. <help:/fundamentals/support.html#docs> This will reduce the amount of off-topic chatter we get here and provide a much-needed list of support resources in the offline documentation. One other thing I think would be awesome if we do this would be to find a way to also provide a way for translators to fill in a section of this new chapter that explains how to get support in their language. Doesn't the translation framework treat <!--TRANS:foo--> type comments specially? Would it be possible to add a <!--TRANS:LANGUAGE_SUPPORT_INFO--> comment or some such to the relevant chapter in fundamentals, and instruct translators to fill in that message with a sectN with useful information for their language. For instance, the Spanish translator(s) would translate that message to something like this: <sectN id="support-lang"> <title>Obtenci?n de Ayuda en Espa?ol</title> <para>Para obtener ayuda para usar las aplicaciones de &kde; en espa?ol, por favor escriba <ulink url="mailto:general at kde-espana.es">general at kde-espana.es</ulink> a trav?s de correo electr?nico.</para> </sectN> This would of course be optional, and if translators don't want to/are unable to because such resources don't exist no section like this will appear. (This also would prevent a "Getting Help in English" section, which doesn't make much sense.) If that won't work, is there another way we could achieve this? -T.C.
