Hi all,

The original convention was to name the documents in their own
language, e.g. Firebird-Sicherheit.html, Firebird-Snelstartgids.pdf.

But when the new website was built - many years ago - the site
builders renamed them to their English names + a language suffix.

This was not discussed and decided in the docs group; I was against
it but the site builders argued that it was better for consistency
and SEO (IIRC!)

So I didn't make a huge point out of it and nor did anybody else.

However, I'm all for going back to the old convention.

Cheers,
Paul

> Hi Mark,
> 
> thank you.
> 
> CKEdit ist he CMS editor of the Firebird homepage. I used it in the past to 
> upload files and so on. But when I start browsing the server's directories I 
> get the error.
> 
> I thought we keep the consistency when naming it 
> "firebird-30-language-reference-de". The russian PDF is also named that way: 
> firebird-language-reference-30-rus.pdf
> That's the only reason. Feel free to rename it.
> 
> Martin
> 
> 
> [https://www.it-syn.de/wp-content/uploads/2013/03/130313-it-synergy-Logo-200x81.png]
> 
> E-Mail: martin.koed...@it-syn.de
> Festnetz: +49 5131 46358 - 300
> Mobil: +49 174 9095174
> 
> 
> Adresse:
> Dieselstraße 18
> 30827 Garbsen
> 
> 
> Geschäftsführer: Jörg Obermann
> USt.-ID: DE266943764
> Gerichtsstand: Amtsgericht Hannover HRB 204887
>         [cid:Synny-standard-122x128_893d5d75-a3d9-4751-8d28-35edcac23c6b.png] 
> <https://www.it-syn.de/>
> 
> [cid:Instagram_b049198f-ae33-4adb-8f4c-c93023d156b5.png]<https://www.instagram.com/it.synergy>
>  <https://plus.google.com/114028260526830186292?prsrc=3/>  
> <http://www.youtube.com/codetwochannel#p/u/>  [tweeter] 
> <https://www.linkedin.com/company/it-synergy-gmbh>
> 
> Vertraulichkeitshinweis: Die in dieser E-Mail enthaltenen Informationen sind 
> vertraulich zu behandeln und sind nur für die Personen oder das Unternehmen 
> bestimmt, an welche sie tatsächlich gerichtet sind. Sollten Sie diese 
> Nachricht aufgrund eines Übermittlungsfehlers erhalten haben, bitten wir Sie 
> den Versender der Nachricht unverzüglich zu informieren. Ebenso bitten wir 
> Sie, den Inhalt Dritten gegenüber vertraulich zu behandeln und ihn nicht 
> weiter zu verbreiten.
> 
> 
> 
> Sicherheitshinweis: Das Internet ist kein sicheres Kommunikationsmedium. Im 
> Rahmen unseres Qualitätsmanagements und aller gebotenen Sorgfalt wurden 
> Schritte eingeleitet die einen Virenbefall dieser E-Mail weitgehend 
> ausschließen, aber wegen der Beschaffenheit des Übertragungsmediums nicht 
> garantiert werden können.
> 
> 
> -----Ursprüngliche Nachricht-----
> Von: Mark Rotteveel [mailto:m...@lawinegevaar.nl]
> Gesendet: Montag, 22. November 2021 12:30
> An: firebird-docs@lists.sourceforge.net
> Betreff: Re: [Firebird-docs] Upload of German lang ref
> 
> On 22-11-2021 11:36, Mark Rotteveel wrote:
> > On 22-11-2021 11:29, Mark Rotteveel wrote:
> >> On 21-11-2021 19:21, Köditz, Martin wrote:
> >>> Hi,
> >>>
> >>> I just finished the German translation of the FB 3.0 language reference.
> >>>
> >>> I cannot upload any files to the homepage. CKEdit says „file not
> >>> found“. Can someone help?
> >>
> >> What is CKEdit? And how do you use it to upload files? Have you been
> >> able to upload files in the past? I use WinSCP to upload files.
> >>
> >> I'll see if I can upload a build of the docs.
> >
> > I noticed a number of broken references within the document because of
> > a missing `-de` suffix. If this CKEdit (which I guess is CKEditor)
> > validates the links between generated HTML files, that might cause the
> > error.
> >
> > I also saw some syntax problems (or at least the highlighter in
> > IntelliJ breaks, which generally points to some syntax problem). I'll
> > try to fix those and upload.
> 
> I fixed the issues and uploaded it. However, I noticed that the file is 
> called firebird-30-language-reference-de (.html/.pdf), while the previous one 
> was called firebird-25-sprachreferenz. Changing this to 
> firebird-30-sprachreferenz is more in line with the naming convention 
> documented in the Docwriting Guide[1] (specifically in "Other file naming 
> conventions").
> 
> Do you have any objections if I make this change, or did you have a specific 
> reason for using firebird-30-language-reference-de?
> 
>   [1]:
> https://firebirdsql.org/file/documentation/html/en/firebirddocs/docwritehowto/firebird-docwriting-guide.html#docwritehowto-asciidoc-project-layout
> 
> Mark


_______________________________________________
Firebird-docs mailing list
Firebird-docs@lists.sourceforge.net
https://lists.sourceforge.net/lists/listinfo/firebird-docs

Reply via email to